用于软件开发者的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

许可证

[项目许可证信息]