JinDaGe - github-mcp-server-fastapi-implementation MCP Details

article

README

🚀 GitHub MCP 服务器 - FastAPI 实现

本项目借助 FastAPI 实现了一个 模型上下文协议（MCP）服务器，能让 AI 助手（如 Claude）与 GitHub 进行交互。服务器提供了一系列 API 端点，可用于获取用户信息、管理仓库、创建问题以及自动化 GitHub 工作流。

✨ 主要特性

✅ 获取 GitHub 用户详情 和仓库
✅ 创建和管理问题 在仓库中
✅ 列出仓库中的所有问题
✅ 星标一个仓库
✅ 带 AI 功能的 GitHub 问题摘要（可选）
✅ 安全 API 使用 GitHub OAuth 令牌
✅ 异步 FastAPI 实现

📦 安装指南

1️⃣ 克隆仓库

git clone https://github.com/snehaapratap/mcp-server.git
cd mcp-server

2️⃣ 创建并激活虚拟环境

python3 -m venv venv
source venv/bin/activate

3️⃣ 安装依赖项

pip install -r requirements.txt

4️⃣ 设置环境变量

在根目录下创建一个 .env 文件，并添加你的 GitHub 个人访问令牌 (PAT)：

GITHUB_TOKEN=your_personal_access_token

5️⃣ 运行 FastAPI 服务器

uvicorn server:app --reload

服务器将在 http://127.0.0.1:8000 上运行。

📚 详细文档

🔥 API 端点

| 方法 | 端点 | 描述 | |------|-----|-------------| | GET | / | 检查 MCP 服务器健康状态 | | GET | /github/user | 获取 GitHub 用户详情 | | GET | /github/repos | 获取认证用户的所有仓库 | | POST | /github/create-issue | 在仓库中创建问题 | | GET | /github/list-issues | 列出仓库中的所有问题 | | PUT | /github/star-repo | 星标一个仓库 | | POST | /github/summarize-issues | 带 AI 功能的问题摘要（可选） |

⚡ 使用示例 (cURL)

🔹 获取用户详情

curl -X GET "http://127.0.0.1:8000/github/user"

🔹 获取仓库

curl -X GET "http://127.0.0.1:8000/github/repos"

🔹 创建问题

curl -X POST "http://127.0.0.1:8000/github/create-issue" \
     -H "Content-Type: application/json" \
     -d '{"owner":"username", "repo":"repository", "title":"Issue Title", "body":"Issue Body"}'

🔹 列出问题

curl -X GET "http://127.0.0.1:8000/github/list-issues?owner=username&repo=repository"

🔹 星标仓库

curl -X PUT "http://127.0.0.1:8000/github/star-repo" \
     -H "Content-Type: application/json" \
     -d '{"owner":"username", "repo":"repository"}'

🛡️ 错误处理

如果出现错误，例如无效的 GitHub 令牌，服务器将返回以下格式的消息：

{
    "error": "Invalid GitHub Token",
    "message": "Please provide a valid GitHub OAuth token."
}

这有助于开发者快速识别和解决错误。

🌟 未来增强

支持管理 pull 请求
添加 WebSocket 实时通知功能
部署到云服务（如 AWS、Azure 或 Google Cloud）

这个项目展示了如何使用 FastAPI 快速构建一个与 GitHub 交互的 API 服务器。通过配置环境变量和简单的命令，开发者可以轻松启动并运行该服务器，开始与 GitHub 进行交互。

github-mcp-server-fastapi-implementation