GitHub MCP（模型上下文协议）服务器

你好！这是我的第一个GitHub MCP 服务器，它允许与MCP兼容的LLLM（如Claude）通过我的MCP服务器与GitHub API交互。

需求

• TypeScript（编程语言）
• Octokit（用于向GitHub发送API请求）
• 模型上下文协议SDK

在本地设置项目

1. 克隆仓库
2. 运行 npm install
3. 根据 .env.example 文件创建一个 .env 文件
4. 为了将TypeScript文件编译为JavaScript，运行 npx tsc
5. 最终运行项目时，运行 node build/index.js

测试方法

你有2种方式可以测试你的MCP服务器：

• MCP检查器
• Claude Desktop

使用MCP检查器测试

1. 在终端中运行 npx @modelcontextprotocol/inspector node build/index.js
2. 打开 http://localhost:5173
3. 现在你可以看到MCP检查器并进行测试。

使用Claude Desktop测试

1. 从这里下载并安装Claude Desktop
2. 转到 File > Settings... > Developer > Edit Config（文件 > 设置... > 开发者 > 编辑配置）
3. 它会打开 claude_desktop_config.json 文件的位置。
4. 在代码编辑器中打开该文件，并添加以下内容：

   {
    "mcpServers": {
      "gh": {
        "command": "node",
        "args": ["绝对\\路径\\到\\你的\\index.js\\文件"],
        "env": {
          "GITHUB_TOKEN": "你的GitHub个人访问令牌"
        }
      }
    }
   }
   

5. 退出并重新打开Claude Desktop

功能

MCP主要支持两个功能：

• 工具（4个）
  • create-issue: 在GitHub仓库中创建新问题
  • get-repo-info: 获取特定GitHub仓库的信息
  • list-issues: 列出GitHub仓库中的问题
  • search-repos: 搜索GitHub仓库
• 提示（5个）
  • create-issue-description: 为GitHub问题生成描述
  • create-pull-request-description: 为GitHub拉取请求生成描述
  • search-repos-prompt: 为搜索GitHub仓库生成查询
  • create-issue-prompt: 为创建GitHub问题生成参数
  • enhance-github-response: 格式化并增强原始GitHub API响应数据

你可以编写自己的提示，或从“选择集成”选项的MCP下拉菜单中选择合适的提示进行测试。