GitHub MCP (Model Context Protocol) server

GitHub MCP（Model Context Protocol）服务

你好！这是一个 GitHub MCP 服务，旨在让 Claude 等兼容 MCP 的大模型与我的 MCP 服务通信，并与 GitHub API 交互。

要求

• TypeScript（编程语言）
• Octokit（用于向 GitHub 发出 API 请求）
• Model Context Protocol SDK

在本地设置项目

1. 克隆仓库
2. 运行 npm install
3. 参照 .env.example 文件中的示例，添加 .env 文件
4. 要将 TypeScript 文件编译为 Javascript，请运行 npx tsc
5. 最后，要运行项目，请运行 node build/index.js

测试方式

可以通过 2 种方式测试 MCP 服务：

• MCP inspector
• Claude Desktop

使用 MCP inspector 测试

1. 在终端中运行 npx @modelcontextprotocol/inspector node build/index.js
2. 前往 http://localhost:5173
3. 现在即可查看 MCP inspector 并进行测试。

使用 Claude Desktop 测试

1. 从此处下载并安装 Claude Desktop
2. 前往 File > Settings... > Developer > Edit Config
3. 此时应该会打开 claude_desktop_config.json 文件所在的位置。
4. 使用代码编辑器打开该文件，并添加以下内容：

   {
    "mcpServers": {
      "gh": {
        "command": "node",
        "args": ["absolute\\path\\to\\your\\index.js\\file"],
        "env": {
          "GITHUB_TOKEN": "your-github-personal-access-token"
        }
      }
    }
   }
   

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 响应数据

你可以编写自己的提示词，也可以在 Claude Desktop 中 MCP 的“Choose an integration”选项下拉菜单中选择合适的提示词