AI助手协议服务

MCP是一种开放标准,使AI助手能够安全地访问外部数据和工具,适用于需要集成多种服务的AI应用场景。

  • by Ivandhr
  • 本地部署
  • 更新于
在 GitHub 查看 ivandhr/mcp-claude

使用说明

MCP克劳德

本地MCP服务器与Claude Desktop MCP客户端集成。

什么是MCP?

模型上下文协议(MCP)是一个开放标准,使AI助手能够安全地访问外部数据和工具。它允许Claude Desktop通过标准化的服务器连接到各种服务和资源。

安装说明

1.安装克劳德桌面

从Anthropic官方网站下载并安装Claude Desktop。

2.配置MCP服务器

Claude Desktop使用配置文件来管理MCP服务器。配置文件的位置取决于您的操作系统:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • 视窗: %APPDATA%\Claude\claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json

3.配置文件

创建或编辑 claude_desktop_config.json 具有以下配置的文件:

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "YOUR_GITHUB_PAT_HERE"
      }
    }
  }
}

4.创建GitHub个人访问令牌

  1. 首选 GitHub设置>开发者设置>个人访问令牌
  2. 点击“生成新令牌(经典)”
  3. 设置适当的到期日期
  4. 选择以下范围:
    • repo (完全控制私有存储库)
    • user (读取用户配置文件数据)
    • workflow (更新GitHub Action工作流)
  5. 点击“生成令牌”
  6. 复制令牌并替换 YOUR_GITHUB_PAT_HERE 在配置中

5.重新启动克劳德桌面

保存配置文件后,重新启动Claude Desktop以加载新的MCP服务器。

特性

配置后,Claude Desktop将可以访问GitHub功能,包括:

  • 存储库管理
  • 文件 操作
  • 问题跟踪
  • 拉取请求管理
  • 代码搜索
  • 用户和组织管理

故障排除

常见问题

  1. 未找到配置文件:确保文件位于操作系统的正确位置
  2. 无效令牌:验证您的GitHub PAT是否有效,是否具有正确的权限
  3. 服务器未加载:检查Node.js是否已安装,npx是否可用
  4. 权限不足:确保PAT具有您要执行的操作所需的范围

验证

要验证设置是否正常工作:

  1. 打开克劳德桌面
  2. 开始新的对话
  3. 试着让Claude帮助GitHub运营
  4. 你应该在Claude的回复中看到与GitHub相关的工具

安全说明

  • 确保您的GitHub个人访问令牌安全
  • 从不将令牌提交到版本控制
  • 考虑对敏感数据使用环境变量
  • 定期轮换代币以提高安全性

其他MCP服务器

此配置可以扩展到包括其他MCP服务器。热门选项包括:

  • 用于本地文件访问的文件系统服务器
  • 用于数据管理的数据库服务器
  • 用于外部服务集成的API服务器

贡献

请随时提交问题和增强请求!

许可证

这个项目是开源的,可以在MIT许可证下使用。