GitHub MCP Server

GitHub MCP Server

概要

GitHub MCP Server は、MCP (Modular Command Processor) フレームワークを使用して GitHub と連携する API ベースのツールです。GitHub の REST API を使用して、ユーザーの詳細情報、リポジトリ情報、認証済みユーザーのデータの取得など、さまざまな機能を提供します。

このプロジェクトは Python で構築されており、非同期 API 呼び出しに httpx を活用しています。また、GitHub 認証トークンを安全に扱うために dotenv も使用します。

機能

• ユーザー名を指定して GitHub ユーザー情報を取得します。
• GitHub リポジトリの詳細情報を取得します。
• GitHub パーソナルアクセストークンを使用して、認証済みユーザーの詳細情報を取得します。
• モジュール式のコマンド処理に FastMCP を使用します。

プロジェクト構成

D:/MCP_Project/ 
|----.env
│----.gitignore
│----claude_desktop_config.json  (Create this file in C:\Users\your_username\AppData\Roaming\Claude\)
│----main.py
│----pyproject.toml
│----README.md
│----requirements.txt

• main.py：GitHub MCP Server のコアロジックです。
• .env：環境変数（GitHub トークンなど）を保存します。
• claude_desktop_config.json：MCP Server の実行設定です。
• requirements.txt：必要な依存関係を記載します。
• explanation_video.mp4：プロジェクトを解説する動画です。

セットアップ手順

前提条件

• Python >=3.10
• GitHub パーソナルアクセストークン（認証済みリクエスト用）
• 仮想環境の管理用の conda または venv

セットアップと使用方法

1. リポジトリをクローンする

   git clone https://github.com/DivyanshKushwaha/GitHub-MCP-Server-Claude.git
   cd GitHub-MCP-Server-Claude
   

2. Python 環境を作成する

python -m venv venv
source venv/bin/activate  

3. 依存関係をインストールする

pip install -r requirements.txt

4. 環境変数を設定する（.env ファイルを作成する）

GITHUB_TOKEN=your_personal_access_token

5. claude_desktop_config.json を設定する

{
    "mcpServers": {
        "MCP_Server": {
            "command": "my_env/Scripts/uv",
            "args": [
                "run",
                "D:/MCP_Project/main.py"
            ]
        }
    }
}

• command キーには、conda 環境にある uv スクリプトのパスを指定します。これはサーバーの実行に使用されます。

• args キーには、uv スクリプトに渡す追加の引数を指定します。

  • "run"：サーバーを実行する操作を示します。
  • my_env：Python 環境 'my_env' です。
  • "D:/MCP_Project/main.py"：MCP サーバーの実装を含む main.py スクリプトのパスを指定します。

6. Claude Desktop アプリケーションを起動する

• Claude Desktop アプリケーションを開きます。
• claude_desktop_config.json ファイルで設定された MCP Server を使用して、データの取得と処理が行われます。