GitHub MCP 服务器

一个用于 GitHub 仓库的模型上下文协议 (MCP) 服务器，使用 Python SDK 构建。

概述

此服务器实现 模型上下文协议 (MCP) 用于 GitHub 仓库，允许 AI 助手访问仓库上下文，例如文件、提交历史、问题和拉取请求。它使用 MCP Python SDK 构建，并设计为部署在 Heroku 上。

特性

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

要求

• 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
   # 使用你的 GitHub API令牌和其他设置编辑 .env 文件
   

使用

本地开发

uvicorn src.mcp_server.main:app --reload

部署

此服务器设计为部署在 Heroku 上。请参阅 部署文档 了解详细信息。

文档

• API 文档
• 配置指南
• 部署指南
• 故障排除

贡献

欢迎贡献！请随意提交 Pull Request。

许可证

此项目 licensed under MIT License - 详情请查看 LICENSE 文件。