GitHub MCP Server

GitHub MCP Server

site icon
2025.03.08 0
PythonGitHub 仓库管理AI 助手集成开发效率
GitHub MCP Server 是一个基于 Python SDK 构建的 Model Context Protocol (MCP) 服务器,专为 GitHub 仓库设计。它允许 AI 助手访问仓库上下文,如文件、提交记录、问题和拉取请求。该服务器支持安全认证、访问控制、速率限制和缓存功能,适用于与 MCP 兼容的 AI 助手。
View on GitHub

Overview

基本能力

产品定位

GitHub MCP Server 是一个为 GitHub 仓库提供上下文访问的 MCP 服务器,旨在帮助 AI 助手高效访问和管理仓库内容。

核心功能

  • 访问 GitHub 仓库文件和内容
  • 检索提交历史
  • 访问问题和拉取请求
  • 安全认证和访问控制
  • 速率限制和 GitHub API 缓存
  • 兼容 MCP 启用的 AI 助手

适用场景

  • AI 助手需要访问 GitHub 仓库内容时
  • 开发团队需要自动化管理仓库问题时
  • 需要集成 MCP 协议的项目

工具列表

  • GitHub API: 用于访问仓库内容、提交记录、问题和拉取请求。
  • MCP Python SDK: 提供 MCP 协议的实现和基础功能。
  • Heroku: 用于服务器部署。

常见问题解答

常见问题请参考 Troubleshooting 文档。

使用教程

使用依赖

  • Python 3.8+
  • GitHub API 访问权限
  • Heroku 账户(用于部署)

安装教程

  1. 克隆仓库: git clone https://github.com/FixingPixels/mcp-server.git cd mcp-server

  2. 创建虚拟环境: python -m venv venv source venv/bin/activate # Windows: venv\Scripts\activate

  3. 安装依赖: pip install -r requirements.txt

  4. 设置环境变量: cp .env.example .env # 编辑 .env 文件,填入 GitHub API token 和其他设置

调试方式

本地开发调试命令:

uvicorn src.mcp_server.main:app --reload

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。