GitHub MCP Server

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Allows to list and create GitHub issues from a repository

GitHub MCP 服务器

用于通过 Cline 与 GitHub 问题交互的模型上下文协议 (MCP) 服务器实现。

特征

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

安装

  1. 克隆存储库:
git clone https://github.com/timbuchinger/mcp-github.git cd mcp-github
  1. 使用 uv 安装依赖项:
pip install uv uv venv source .venv/bin/activate # On Windows: .venv\Scripts\activate uv pip install -r requirements.txt
  1. 复制环境模板并配置你的 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 公开两个工具:

获取问题

从 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 .
-
security - not tested
F
license - not found
-
quality - not tested

通过模型上下文协议实现与 GitHub 问题的交互,允许用户通过安全身份验证列出和创建问题。

  1. Features
    1. Installation
      1. Usage
        1. get_issues
        2. create_issue
      2. Error Handling
        1. Development
          ID: j37nzp7f8j