Claude Ts Mcps

🚀 用于软件开发者的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或更高版本。

安装步骤

1. 克隆此仓库：

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

2. 安装依赖项：

   cd your-repository
   npm install
   

3. 启动服务器：

   npm start
   

📚 详细文档

配置说明

加载配置文件

1. 打开Claude Desktop。
2. 导入config.json文件（位于项目根目录）。
3. 确保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`规则（请谨慎使用）
}

使用方法

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

开发指南

每个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转换。

添加新功能

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

🔧 技术细节

安全注意事项

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

参考资料

• 模型上下文协议（Model Context Protocol）
• MCP服务器快速入门指南
• Anthropic Claude

📄 许可证

[项目许可证信息]