项目简介
本项目 claude-ts-mcps 是一系列 Model Context Protocol (MCP) 服务器的集合,旨在增强 Anthropic Claude Desktop 应用程序在软件开发方面的能力。通过使用这些服务器,开发者可以利用 Claude Pro 订阅,避免高昂的按次付费 API 费用,同时获得与 Cline 类似甚至更强大的开发辅助功能。
主要功能点
本项目包含多个独立的 MCP 服务器,每个服务器提供不同的功能,包括:
- Brave Search: 通过 Brave Search API 提供网页搜索和本地搜索功能,帮助 Claude 获取最新的网络信息和地点信息。
- Filesystem: 允许 Claude 安全地访问和操作本地文件系统,进行文件读取、写入、编辑和目录管理等操作。
- Git: 集成 Git 命令,让 Claude 能够执行版本控制操作,如查看状态、提交更改、查看日志和管理分支等。
- GitHub: 使 Claude 可以与 GitHub 仓库互动,包括文件操作、Issue 和 Pull Request 管理等,方便代码协作和项目管理。
- Shell: 允许 Claude 在受控环境中执行 Shell 命令,扩展其自动化和系统管理能力。
- Puppeteer: 支持浏览器自动化,让 Claude 可以模拟用户在网页上的操作,如页面导航、截图、点击和表单填写等。
- Fetch: 允许 Claude 从 URL 获取网页内容,并转换为 Markdown 格式,提高可读性。
安装步骤
-
克隆仓库
打开终端,执行以下命令克隆仓库到本地:
git clone https://github.com/ukkz/claude-ts-mcps.git cd claude-ts-mcps -
安装依赖
确保您已安装 Node.js (v18+) 和 Bun 运行时。然后在仓库目录下运行命令安装项目依赖:
bun install
服务器配置
要将这些 MCP 服务器与 Claude Desktop 配合使用,您需要创建一个配置文件 'claude_desktop_config.json',告知 Claude 如何连接这些服务器。以下是一个示例配置,请根据您的实际路径进行修改:
{ "mcpServers": { "brave-search": { "command": "/Users/username/.bun/bin/bun", // Bun 运行时命令路径,请替换为您的实际路径 "args": [ "run", "/Users/username/Documents/claude-ts-mcps/src/brave-search.ts" // brave-search 服务器脚本路径,请替换为您的实际路径 ], "env": { "BRAVE_API_KEY": "YOUR_BRAVE_API_KEY" // Brave Search API 密钥,您需要申请并替换为您的密钥 } }, "filesystem": { "command": "/Users/username/.bun/bin/bun", // Bun 运行时命令路径,请替换为您的实际路径 "args": [ "run", "/Users/username/Documents/claude-ts-mcps/src/filesystem.ts", // filesystem 服务器脚本路径,请替换为您的实际路径 "/Users/username" // 允许访问的根目录,请根据需要修改,可以添加多个目录 ] }, "git": { "command": "/Users/username/.bun/bin/bun", // Bun 运行时命令路径,请替换为您的实际路径 "args": [ "run", "/Users/username/Documents/claude-ts-mcps/src/git.ts" // git 服务器脚本路径,请替换为您的实际路径 ] }, "github": { "command": "/Users/username/.bun/bin/bun", // Bun 运行时命令路径,请替换为您的实际路径 "args": [ "run", "/Users/username/Documents/claude-ts-mcps/src/github.ts" // github 服务器脚本路径,请替换为您的实际路径 ], "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "YOUR_DEFAULT_TOKEN", // 您的默认 GitHub 个人访问令牌,用于访问 GitHub API "GITHUB_TOKEN_WORK": "YOUR_WORK_ACCOUNT_TOKEN", // (可选)您的工作账户 GitHub 令牌 "GITHUB_TOKEN_PERSONAL": "YOUR_PERSONAL_ACCOUNT_TOKEN" // (可选)您的个人账户 GitHub 令牌 } }, "shell": { "command": "/Users/username/.bun/bin/bun", // Bun 运行时命令路径,请替换为您的实际路径 "args": [ "run", "/Users/username/Documents/claude-ts-mcps/src/shell.ts" // shell 服务器脚本路径,请替换为您的实际路径 ] }, "puppeteer": { "command": "/Users/username/.bun/bin/bun", // Bun 运行时命令路径,请替换为您的实际路径 "args": [ "run", "/Users/username/Documents/claude-ts-mcps/src/puppeteer.ts" // puppeteer 服务器脚本路径,请替换为您的实际路径 ] }, "fetch": { "command": "/Users/username/.bun/bin/bun", // Bun 运行时命令路径,请替换为您的实际路径 "args": [ "run", "/Users/username/Documents/claude-ts-mcps/src/fetch.ts" // fetch 服务器脚本路径,请替换为您的实际路径 ], "env": { "CUSTOM_USER_AGENT": "YOUR_CUSTOM_USER_AGENT", // (可选)自定义 User-Agent 字符串 "IGNORE_ROBOTS_TXT": "false" // (可选)是否忽略 robots.txt 规则,默认为 false } } } }
将以上配置保存为 'claude_desktop_config.json' 文件,并按照 Claude Desktop 的指引加载此配置文件。
基本使用方法
- 启动 Claude Desktop 应用程序。
- 加载配置文件:在 Claude Desktop 中配置并加载您创建的 'claude_desktop_config.json' 文件。
- 使用扩展功能:Claude Desktop 现在将能够访问由这些 MCP 服务器提供的工具。您可以在与 Claude 对话时,通过自然语言指示 Claude 使用这些工具,例如进行网页搜索、读取文件、执行 Git 命令等。
具体工具的使用方法请参考每个工具的描述信息,在 Claude Desktop 中通常可以通过提示词或者特定的操作来触发工具的调用。
信息
分类
开发者工具