金大哥 - claude-ts-mcps MCP 详情

article

README

🚀 用于软件开发者的Claude TypeScript MCP服务器

本项目是一个Model Context Protocol（MCP）服务器集合，专为使用大语言模型（LLM）进行开发协助的软件开发者打造。许多开发者青睐Cline的直接VSCode集成，但API费用过高是个难题。本项目通过实现一组强大的MCP服务器，有效解决了这一问题。

🚀 快速开始

Claude TypeScript MCP服务器是一组用TypeScript编写的定制化工具，能增强Claude Desktop的功能。这些服务器提供了文件系统操作、Git版本控制、GitHub集成、浏览器自动化及URL内容检索等实用工具，助力开发者更高效地完成日常任务。

✨ 主要特性

功能

Brave Search：借助Brave Search API，实现快速且注重隐私的网络搜索。
文件系统：提供安全的文件操作功能，涵盖读取、写入和目录管理。
Git：支持完整的Git版本控制操作，如提交、拉取和切换分支。
GitHub：集成GitHub API，支持仓库管理、问题跟踪和Pull Request操作。
Shell命令：允许在受控环境中执行系统命令。
Puppeteer：实现浏览器自动化，用于网页抓取和交互测试。
Fetch：支持从URL获取内容，并具备HTML到Markdown的转换功能。

安全

所有服务器都内置了严格的安全措施：

文件系统和Shell服务器会对访问权限进行限制。
Shell命令执行基于白名单机制，仅允许特定的安全命令。
Fetch服务器默认遵守robots.txt规则，避免不必要的网络抓取冲突。

📦 安装指南

使用前的准备

系统要求

操作系统：支持Node.js的任何现代操作系统（Windows、macOS、Linux）。
Node.js版本：16.0或更高版本。
npm版本：6.0或更高版本。

安装步骤

克隆此仓库：

git clone https://github.com/your-repository.git

安装依赖项：
```
cd your-repository
npm install
```
启动服务器：
```
npm start
```

📚 详细文档

配置说明

加载配置文件

打开Claude Desktop。
导入config.json文件（位于项目根目录）。
确保Claude Desktop能够访问必要的环境变量。

环境变量配置

GitHub服务器

GitHub MCP服务器支持多账户配置：

"env": {
    "GITHUB_PERSONAL_TOKEN": "your-personal-token",
    "GITHUB_WORK_ACCOUNT_TOKEN": "your-work-account-token"
}

在请求中指定account_profile参数以选择特定的账户：

{
    "owner": "username",
    "repo": "repo-name",
    "path": "path/to/file.txt",
    "account_profile": "work" // 使用工作账户令牌
}

Fetch服务器

通过环境变量自定义Fetch行为：

"env": {
    "CUSTOM_USER_AGENT": "YourCustomAgent/1.0", // 自定义User - Agent字符串
    "IGNORE_ROBOTS_TXT": "true" // 忽略`robots.txt`规则（请谨慎使用）
}

使用方法

启动Claude Desktop。
加载项目根目录中的config.json文件。
开始使用新的工具功能。

开发指南

每个MCP服务器都是独立的TypeScript模块，位于src目录中：

src/brave-search.ts：Brave Search API集成。
src/filesystem.ts：文件系统操作。
src/git.ts：Git命令执行。
src/github.ts：GitHub API集成（包括仓库、问题和Pull Request）。
src/shell.ts：受控的Shell命令执行。
src/puppeteer.ts：浏览器自动化功能。
src/fetch.ts：URL内容检索和HTML到Markdown转换。

添加新功能

在src目录下创建一个新的TypeScript文件。
使用@modelcontextprotocol/sdk实现新的MCP服务器。
将新服务器添加到配置文件中。

🔧 技术细节

安全注意事项

文件系统和Shell服务器严格限制了访问权限，防止未授权操作。
始终对用户输入进行验证，避免命令注入攻击。
配置时谨慎选择允许的目录路径。
使用受信任的来源获取GitHub令牌，并确保其安全存储。

参考资料

📄 许可证

[项目许可证信息]

claude-ts-mcps