🚀 用于软件开发者的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令牌，并确保其安全存储。
参考资料
📄 许可证
[项目许可证信息]