GitHub MCP 服务器

一个模型上下文协议 (MCP) 服务器实现，用于通过 Cline 与 GitHub issues 进行交互。

功能特性

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

安装

1. 克隆仓库：

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

2. 使用 uv 安装依赖：

pip install uv
uv venv
source .venv/bin/activate  # 在 Windows 上: .venv\Scripts\activate
uv pip install -r requirements.txt

3. 复制环境模板并配置您的 GitHub token：

cp .env.template .env

编辑 .env 并添加您的 GitHub Personal Access Token：

GITHUB_TOKEN=your_token_here

要创建 GitHub Personal Access Token：

1. 前往 GitHub 设置 -> 开发者设置 -> Personal access tokens
2. 生成一个具有 repo 作用域的新 token
3. 复制 token 并将其粘贴到您的 .env 文件中

使用方法

运行 MCP 服务器：

python -m src.mcp_github.server

服务器将启动并向 Cline 公开两个工具：

get_issues

从 GitHub 仓库获取 issues 列表：

{
  "repo": "owner/repo"
}

create_issue

在 GitHub 仓库中创建一个新的 issue：

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

错误处理

服务器处理常见错误：

• 缺少 GitHub token
• 无效的仓库名称
• 缺少必需的参数
• GitHub API 错误

错误响应包含描述性消息，以帮助排除问题。

开发

该项目使用 uv 进行依赖管理。 要设置开发环境：

# 安装所有依赖项（包括开发依赖项）
uv pip install -r requirements.txt

# 运行测试
pytest

# 格式化代码
black .

# 类型检查
mypy .