Github MCP Server Fastapi Implementation

🚀 GitHub MCP 服务器 - FastAPI 实现

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

🚀 快速开始

本项目使用 FastAPI 实现了一个模型上下文协议（MCP）服务器，使 AI 助手能够与 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 端点

💻 使用示例

基础用法

以下是使用 cURL 调用 API 端点的示例：

🔹 获取用户详情

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 进行交互。