GitHub MCP 服务器

一个通过 Cline 与GitHub 问题交互的 Model Context Protocol (MCP) 服务器实现。

功能

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

安装

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令牌：

cp .env.template .env

编辑 .env 文件并在其中添加您的GitHub个人访问令牌：

GITHUB_TOKEN=your_token_here

创建GitHub个人访问令牌的方法：

1. 转到 GitHub 设置 -> 开发者设置 -> 个人访问令牌
2. 使用 repo 权限生成新的令牌
3. 复制令牌并将其粘贴到您的 .env 文件中

使用方法

运行 MCP 服务器：

python -m src.mcp_github.server

该服务器将向 Cline 暴露两个工具：

get_issues

从GitHub仓库获取问题列表：

{
  "repo": "owner/repo"
}

create_issue

在GitHub仓库创建新问题：

{
  "repo": "owner/repo",
  "title": "问题标题",
  "body": "问题描述"
}

错误处理

服务器处理常见错误：

• 缺少GitHub令牌
• 无效的仓库名称
• 必要参数缺失
• GitHub API 错误

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

开发

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

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

# 运行测试
pytest

# 格式化代码
black .

# 类型检查
mypy .