GitHub MCP Server

GitHub MCP Server

site icon
2025.03.18 0
PythonGitHub 交互API 服务器仓库管理开发效率交流协作
MCP-server 是一个基于 FastAPI 的服务器,实现了用于 GitHub 交互的 Model Context Protocol。它提供了与 GitHub 仓库交互的 API 端点,包括获取仓库详情、列出问题、创建问题和评论等功能。
View on GitHub

Overview

基本能力

产品定位

MCP-server 是一个用于与 GitHub 交互的 API 服务器,旨在简化 GitHub 仓库的管理和操作。

核心功能

  1. 获取仓库详情:通过 GET /repository/{owner}/{repo} 获取指定仓库的详细信息。
  2. 列出问题:通过 GET /repository/{owner}/{repo}/issues 列出指定仓库的所有问题。
  3. 创建问题:通过 POST /repository/{owner}/{repo}/issues 在指定仓库中创建新问题。
  4. 创建评论:通过 POST /repository/{owner}/{repo}/issues/{issue_number}/comments 在指定问题的评论中创建新评论。
  5. 错误处理:服务器实现了全面的错误处理机制,所有 GitHub API 交互的错误都会被记录并返回适当的 HTTP 状态码。
  6. 类型提示:代码库全面使用类型提示,以提高可维护性和 IDE 支持。

适用场景

  1. 自动化 GitHub 仓库管理:适用于需要自动化管理 GitHub 仓库的开发团队或个人开发者。
  2. 集成 GitHub 功能:适用于需要将 GitHub 功能集成到其他应用或服务中的场景。
  3. 开发工具链:适用于构建开发工具链,提高开发效率。

使用教程

使用依赖

  1. 克隆仓库。
  2. 创建虚拟环境: bash python -m venv venv source venv/bin/activate
  3. 安装依赖: bash pip install -r requirements.txt
  4. 创建 .env 文件并添加 GitHub 个人访问令牌: GITHUB_TOKEN=your_token_here

安装教程

  1. 启动服务器: bash uvicorn server:app --reload --port 8000

调试方式

  1. 启动服务器后,可以通过访问以下 API 端点进行调试:
  2. GET /repository/{owner}/{repo}
  3. GET /repository/{owner}/{repo}/issues
  4. POST /repository/{owner}/{repo}/issues
  5. POST /repository/{owner}/{repo}/issues/{issue_number}/comments
  6. 检查服务器日志以查看错误信息。

许可证

None