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