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

你好！这是我的第一个 GitHub MCP 服务器，它允许像 Claude 这样的 MCP 兼容 大型语言模型与我的 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

测试方法

你可以通过以下两种方式测试你的 MCP 服务器：

• MCP 检查器
• Claude 桌面版

使用 MCP 检查器测试

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

使用 Claude 桌面版测试

1. 从 这里 下载并安装 Claude 桌面版

2. 转到 文件 > 设置... > 开发者 > 编辑配置

3. 它应该会打开 claude_desktop_config.json 文件的位置。

4. 在代码编辑器中打开该文件，并添加以下内容：
   json
   {
   "mcpServers": {
   "gh": {
   "command": "node",
   "args": ["absolute\path\to\your\index.js\file"],
   "env": {
   "GITHUB_TOKEN": "your-github-personal-access-token"
   }
   }
   }
   }

5. 退出并重新打开 Claude 桌面版

功能

MCP 主要支持 两个 特性：

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

你可以编写自己的提示，或者在 Claude 桌面版的 MCP 的“选择一个集成”选项中从下拉菜单中选择一个合适的提示。