使用说明

项目简介

Claude-MCP 是一个为 Claude 桌面应用设计的 MCP (Model Context Protocol) 服务器集合。它通过提供一系列工具，扩展了 Claude 与外部世界交互的能力。目前包含三个独立的 MCP 服务器：

文件系统服务器 (Filesystem Server): 允许 Claude 访问和操作本地文件系统，例如读取、写入和列出文件。
GitHub 服务器 (GitHub Server): 使 Claude 能够与 GitHub API 交互，例如获取用户仓库、 issues 和 pull requests 信息。
Brave 搜索服务器 (Brave Search Server): 集成 Brave 搜索引擎，让 Claude 可以进行网页搜索和获取搜索建议。

主要功能点

文件系统操作:
- 'read_file': 读取指定路径的文件内容。
- 'write_file': 将指定内容写入到指定路径的文件中。
- 'list_files': 列出指定目录下的文件和子目录。
GitHub API 交互:
- 'fetch_repositories': 获取指定 GitHub 用户的仓库列表。
- 'fetch_issues': 获取指定 GitHub 仓库的 issues 列表。
- 'fetch_pull_requests': 获取指定 GitHub 仓库的 pull requests 列表。
Brave 网页搜索:
- 'search': 使用 Brave 搜索引擎进行网页搜索。
- 'get_suggestions': 获取搜索关键词的建议。

安装步骤

安装 Node.js 和 npm: 确保你的系统已安装 Node.js 和 npm (Node 包管理器)。

克隆仓库: 将 Claude-MCP 仓库克隆到本地：

git clone https://github.com/jamcam-me/Claude-MCP.git
cd Claude-MCP

安装依赖: 在仓库根目录下运行以下命令安装项目依赖：
```
npm install
```

服务器配置

要将这些 MCP 服务器连接到 Claude 桌面应用，你需要编辑 Claude 的配置文件 'claude_desktop_config.json'。该文件通常位于：

Windows: 'c:/Users/[Your Username]/AppData/Roaming/Claude/claude_desktop_config.json'
macOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
Linux: '~/.config/Claude/claude_desktop_config.json' 或 '~/.var/app/com.anthropic.claude-desktop/config/Claude/claude_desktop_config.json' (Flatpak)

在 'claude_desktop_config.json' 文件中，找到或创建 '"mcpServers"' 字段，并添加以下配置信息。请根据你的实际文件路径修改 'args' 中的路径。

{
  "mcpServers": {
    "github": {
      "command": "node",
      "args": ["/path/to/Claude-MCP/src/mcp-servers/github-server.js"],  // 修改为 github-server.js 的实际路径
      "env": {
        "GITHUB_API_TOKEN": "your-github-token" // 可选: 你的 GitHub API Token，用于提高 GitHub API 的请求频率限制
      },
      "disabled": false,
      "autoApprove": []
    },
    "brave-search": {
      "command": "node",
      "args": ["/path/to/Claude-MCP/src/mcp-servers/brave-search-server.js"], // 修改为 brave-search-server.js 的实际路径
      "env": {
        "BRAVE_SEARCH_API_KEY": "your-brave-search-api-key" // 你的 Brave Search API Key，必须配置才能使用 Brave 搜索
      },
      "disabled": false,
      "autoApprove": []
    },
    "filesystem": {
      "command": "node",
      "args": ["/path/to/Claude-MCP/src/mcp-servers/filesystem-server.js"], // 修改为 filesystem-server.js 的实际路径
      "env": {
        "FILESYSTEM_BASE_DIRS": "/path/to/Claude-MCP,/path/to/your/data/directory" // 文件系统服务器允许访问的基础目录，用逗号分隔
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

配置说明:

'"mcpServers"': Claude 桌面应用的 MCP 服务器配置部分。
'"github"', '"brave-search"', '"filesystem"': 分别是 GitHub 服务器、Brave 搜索服务器和文件系统服务器的配置名称，可以自定义。
'"command": "node"': 指定启动服务器的命令为 'node' (Node.js 运行时)。
'"args"': 启动服务器的参数，这里指定了各个服务器 JavaScript 文件的路径。请务必根据你的实际仓库路径修改这些路径。
'"env"': 环境变量配置。
- '"GITHUB_API_TOKEN"': GitHub API 令牌，用于提高 GitHub API 的请求频率限制。非必须，但建议配置。
- '"BRAVE_SEARCH_API_KEY"': Brave Search API 密钥，必须配置才能使用 Brave 搜索功能。你需要在 Brave Search 开发者平台获取 API 密钥。
- '"FILESYSTEM_BASE_DIRS"': 文件系统服务器允许访问的基础目录列表，用逗号分隔。服务器只能访问这些目录及其子目录下的文件，用于安全限制。
'"disabled": false': 设置为 'false' 表示启用该服务器。
'"autoApprove": []': 自动批准列表，用于配置哪些工具调用无需用户手动批准。

基本使用方法

启动 MCP 服务器: 在 Claude-MCP 仓库根目录下，分别运行以下命令启动各个 MCP 服务器：

npm run start:github
npm run start:brave-search
npm run start:filesystem

或者一次性启动所有服务器：

npm run start:all

请保持这些终端窗口运行，它们是 MCP 服务器的进程。

在 Claude 中使用工具: 配置完成后，你就可以在 Claude 中通过自然语言指令来使用这些工具了。例如：
- 文件系统操作: "读取 'data/sample.txt' 文件的内容", "将 'Hello Claude!' 写入到 'output.txt' 文件中", "列出 'data' 目录下的文件"。
- GitHub 操作: "获取 'github' 用户 'jamcam-me' 的仓库列表", "获取 'facebook/react' 仓库的 issues", "获取 'vuejs/vue-next' 仓库的 pull requests"。
- Brave 搜索: "使用 Brave 搜索关于气候变化的信息", "为关键词 '人工智能' 获取搜索建议"。
Claude 可能会在首次使用工具时请求你批准授权，根据提示操作即可。如果你在配置文件中设置了 '"autoApprove"', 则指定的工具调用将自动批准。

注意:

确保你已正确配置 'claude_desktop_config.json' 文件中的路径和 API 密钥。
文件系统服务器的安全性取决于 '"FILESYSTEM_BASE_DIRS"' 的配置，请谨慎设置允许访问的目录。
Brave Search API 需要 API 密钥才能使用，请前往 Brave Search 开发者平台获取。
GitHub API token 是可选的，但建议配置以提高 API 请求频率限制，尤其是在频繁使用 GitHub 工具时。

关键词

使用说明

信息