Github MCP Server Fastapi Implementation

🚀 GitHub MCP サーバー - FastAPI 実装

このプロジェクトは FastAPI を使用して、モデルコンテキストプロトコル（MCP）サーバー を実装しています。これにより、Claude などの AI アシスタントが GitHub とやり取りできるようになります。サーバーは、ユーザー情報の取得、リポジトリの管理、問題の作成、GitHub ワークフローの自動化などの API エンドポイントを提供します。

✨ 主な機能

• ✅ GitHub ユーザー詳細 とリポジトリの取得
• ✅ リポジトリ内での 問題の作成と管理
• ✅ リポジトリ内のすべての 問題の一覧表示
• ✅ リポジトリの 星印付け
• ✅ AI 機能付きの GitHub 問題要約（オプション）
• ✅ GitHub OAuth トークン を使用した安全な API
• ✅ 非同期 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 で起動します。

💻 使用例

🔹 ユーザー詳細の取得

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"}'

📚 ドキュメント

🔥 API エンドポイント

🛡️ エラー処理

エラーが発生した場合、例えば無効な GitHub トークンが提供された場合、サーバーは以下の形式のメッセージを返します。

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

これにより、開発者はエラーを迅速に識別して解決することができます。

🌟 未来の拡張機能

• プルリクエストの管理をサポート
• WebSocket を使用したリアルタイム通知機能の追加
• クラウドサービス（AWS、Azure、Google Cloud など）へのデプロイ

このプロジェクトは、FastAPI を使用して GitHub とやり取りする API サーバーを迅速に構築する方法を示しています。環境変数の設定と簡単なコマンドにより、開発者はサーバーを簡単に起動して、GitHub とのやり取りを開始することができます。