GitHub MCP Server

基本能力

产品定位

GitHub MCP Server 是一个用于与 GitHub 问题进行交互的服务，旨在简化 GitHub 问题的管理和创建流程。

核心功能

• 列出 GitHub 仓库中的问题
• 创建新的 GitHub 问题
• 错误处理和验证
• 通过环境变量进行安全认证

适用场景

• 开发团队需要自动化管理 GitHub 问题
• 开发者需要快速创建或查看 GitHub 问题
• 需要与 GitHub API 进行安全交互的场景

工具列表

• get_issues: 获取 GitHub 仓库中的问题列表
• create_issue: 在 GitHub 仓库中创建新问题

常见问题解答

• 缺少 GitHub token: 确保在 .env 文件中配置了 GITHUB_TOKEN
• 无效的仓库名称: 检查 repo 参数格式是否为 owner/repo
• 缺少必要参数: 确保请求中包含所有必要参数
• GitHub API 错误: 根据错误消息进行排查

使用教程

使用依赖

1. 安装 uv:

pip install uv

1. 创建虚拟环境并激活:

uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

安装教程

1. 克隆仓库:

git clone https://github.com/timbuchinger/mcp-github.git
cd mcp-github

1. 安装依赖:

uv pip install -r requirements.txt

1. 配置环境变量:

cp .env.template .env

编辑 .env 文件，添加 GitHub Personal Access Token:

GITHUB_TOKEN=your_token_here

调试方式

1. 运行 MCP 服务器:

python -m src.mcp_github.server

1. 使用 get_issues 工具获取问题列表:

{
  "repo": "owner/repo"
}

1. 使用 create_issue 工具创建新问题:

{
  "repo": "owner/repo",
  "title": "Issue title",
  "body": "Issue description"
}

许可证

None