GitHub MCP 服务器
用于通过 Cline 与 GitHub 问题交互的模型上下文协议 (MCP) 服务器实现。
特征
- 列出存储库中的 GitHub 问题
- 创建新的 GitHub 问题
- 错误处理和验证
- 通过环境变量进行安全身份验证
安装
- 克隆存储库:
git clone https://github.com/timbuchinger/mcp-github.git
cd mcp-github
- 使用 uv 安装依赖项:
pip install uv
uv venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate
uv pip install -r requirements.txt
- 复制环境模板并配置你的 GitHub 令牌:
编辑.env
并添加您的 GitHub 个人访问令牌:
GITHUB_TOKEN=your_token_here
要创建 GitHub 个人访问令牌:
- 转到 GitHub 设置 -> 开发者设置 -> 个人访问令牌
- 生成具有
repo
范围的新令牌 - 复制令牌并将其粘贴到您的
.env
文件中
用法
运行 MCP 服务器:
python -m src.mcp_github.server
服务器将启动并向 Cline 公开两个工具:
获取问题
从 GitHub 存储库获取问题列表:
创建问题
在 GitHub 存储库中创建新问题:
{
"repo": "owner/repo",
"title": "Issue title",
"body": "Issue description"
}
错误处理
服务器处理常见错误:
- 缺少 GitHub 令牌
- 存储库名称无效
- 缺少必需参数
- GitHub API 错误
错误响应包括描述性消息以帮助解决问题。
发展
该项目使用 uv 进行依赖管理。要设置开发环境:
# Install all dependencies (including dev dependencies)
uv pip install -r requirements.txt
# Run tests
pytest
# Format code
black .
# Type checking
mypy .