项目简介

本项目 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 格式,提高可读性。

安装步骤

  1. 克隆仓库

    打开终端,执行以下命令克隆仓库到本地:

    git clone https://github.com/ukkz/claude-ts-mcps.git
    cd claude-ts-mcps
  2. 安装依赖

    确保您已安装 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 的指引加载此配置文件。

基本使用方法

  1. 启动 Claude Desktop 应用程序。
  2. 加载配置文件:在 Claude Desktop 中配置并加载您创建的 'claude_desktop_config.json' 文件。
  3. 使用扩展功能:Claude Desktop 现在将能够访问由这些 MCP 服务器提供的工具。您可以在与 Claude 对话时,通过自然语言指示 Claude 使用这些工具,例如进行网页搜索、读取文件、执行 Git 命令等。

具体工具的使用方法请参考每个工具的描述信息,在 Claude Desktop 中通常可以通过提示词或者特定的操作来触发工具的调用。

信息

分类

开发者工具