使用说明
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令牌：
cp .env.template .env
编辑 .env 并添加您的GitHub个人访问令牌：
GITHUB_TOKEN=your_token_here
要创建GitHub个人访问令牌：
- 转到GitHub设置->开发人员设置->个人访问令牌
- 使用生成新令牌
repo范围 - 复制令牌并将其粘贴到您的
.env文件
用法
运行MCP服务器：
python -m src.mcp_github.server
服务器将启动并向Cline公开两个工具：
获取问题
从GitHub存储库获取问题列表：
{
"repo": "owner/repo"
}
创建_发行
在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 .
