GitHub GraphQL API MCP

GitHub GraphQL APIのクエリと使用のためのMCP（モデル制御プロトコル）ベースのツールです。このプロジェクトは、GitHub GraphQLスキーマを探索し、MCPクライアントツール（Claude AIなど）を介してGraphQLクエリを実行できるサーバーを提供します。

GitHub GraphQL API を使用する理由

GitHub GraphQL API は、従来の REST API に比べて大きな利点を提供します。

正確なデータ取得:GraphQLを使用すると、クライアントは必要なフィールドを正確に指定でき、余分なデータを避けることができます。
トークン消費量の削減: 必要なフィールドのみを要求することで、API 応答サイズが大幅に削減され、AI モデルのトークン消費量が削減されます。
関連データに対する単一のリクエスト: 1回のクエリで複数の関連リソースを取得できるため、リクエスト数が削減されます。
自己文書化: 組み込みのドキュメントシステムを通じて、外部ドキュメントなしでAPIスキーマを直接照会して理解することができます。
強力な型システム: 型チェックを提供し、エラーを削減します

このプロジェクトは、これらの利点を活用して、GitHub GraphQL API スキーマを効果的に探索し、最適化されたクエリを実行するのに役立つツールを提供し、AI アシスタントに効率的な GitHub データ取得機能を提供します。

アプリケーションシナリオ

基本機能

このツールは、次の一般的な操作を簡単に実装します。

リポジトリ基本情報クエリ: リポジトリ名、説明、スター数、ブランチリスト、その他の基本情報を取得します。
問題データの取得: 特定のリポジトリの問題リスト、詳細、またはコメントの内容を照会します。
ユーザープロフィールアクセス: ユーザーの個人プロフィール、貢献統計、その他の公開情報を取得します
プルリクエストステータスビュー: PRの基本ステータス、コメント内容、マージ情報を取得します
プロジェクト依存関係クエリ: プロジェクトの依存関係パッケージリストとバージョン情報を取得します

探索的な高度な機能

GraphQL の柔軟なクエリ機能を使用すると、次のような高度な分析機能を実装することもできます。

リポジトリ貢献傾向分析:コミットデータを集約し、プロジェクト活動を評価することで、コードの更新頻度と貢献者の参加を分析します。
問題管理と分類: カスタム条件に従って問題データを整理し、優先的に処理する必要がある問題を発見し、プロジェクト管理の効率を向上させます。
コードレビューパターン分析: PRコメントとレビュープロセスを分析し、一般的な問題パターンを特定し、コードレビューワークフローを最適化します。
貢献者ネットワークの可視化: プロジェクトの貢献者間の協力関係を構築し、主要な貢献者と専門分野を発見します。
依存関係の健全性評価: プロジェクトの依存関係の更新頻度と潜在的なセキュリティ問題を評価し、依存関係管理の提案を提供します。

特徴

GitHub GraphQL スキーマのルートタイプをクエリする (クエリ/ミューテーション)
特定のタイプの詳細なドキュメントを入手する
特定のフィールドのクエリドキュメントとパラメータ
GitHub GraphQL APIクエリを直接実行し、必要なデータを正確に取得してトークンの消費を削減します。
バイリンガルサポート（英語/中国語）

前提条件

Python 3.10以上
GitHub 個人アクセストークン (GitHub API にアクセスするためのもの)
Poetry（推奨依存関係管理ツール）

インストール

リポジトリをクローンします。

git clone https://github.com/wanzunz/github_graphql_api_mcp.git
cd github_graphql_api_mcp

Poetry を使用して依存関係をインストールします。

# If you haven't installed Poetry yet, install it first:
# curl -sSL https://install.python-poetry.org | python3 -

# Install dependencies using Poetry
poetry install

# Activate the virtual environment
poetry shell

Poetry を使用しない場合は、従来の方法を使用できます。

# Create and activate a virtual environment
python -m venv .venv
source .venv/bin/activate  # Linux/MacOS
# or
.venv\Scripts\activate  # Windows

# Install dependencies
pip install -e .

環境変数を設定します。

.envファイルを作成し、GitHub 個人アクセストークンを追加します。

GITHUB_TOKEN="your_github_token_here"

.env.exampleファイルをコピーして作成できます。

cp .env.example .env

次に、 .envファイルを編集して、 your_github_token_here実際の GitHub トークンに置き換えます。

使用法

サーバーの起動

Poetry 仮想環境 ( poetry shell ) がアクティブになっていることを確認してから、次の手順を実行します。

走る

python github_graphql_api_mcp_server.py

サーバーが起動したら、MCP クライアント (Claude AI など) を介してサーバーに接続できます。

Claude Desktopで設定する

Claude デスクトップアプリでこの MCP サーバーを構成して、ワンクリックで起動することができます。

Claudeデスクトップアプリを開く
設定に移動し、MCPサーバー構成セクションを見つけます
次の構成を追加します (実際のパスに応じて変更してください)。

{
    "mcpServers": {
        "github_mcp": {
            "command": "<your Python interpreter path>",
            "args": [
                "--directory",
                "<project path>",
                "run",
                "github_graphql_api_mcp_server.py"
            ]
        }
    }
}

設定例:

{
    "mcpServers": {
        "github_mcp": {
            "command": "/usr/bin/python3",
            "args": [
                "--directory",
                "/home/user/projects/github_graphql_api_mcp/",
                "run",
                "github_graphql_api_mcp_server.py"
            ]
        }
    }
}

conda またはその他の環境管理ツールを使用する場合:

{
    "mcpServers": {
        "github_mcp": {
            "command": "/opt/miniconda3/bin/python",
            "args": [
                "--directory",
                "/Users/username/github/github_graphql_api_mcp/",
                "run",
                "github_graphql_api_mcp_server.py"
            ]
        }
    }
}

設定後は、手動で起動しなくても、Claude デスクトップアプリから直接 MCP サーバーを起動できます。

利用可能なツール

サーバーは次のツールを提供します。

print_type_field : GitHub GraphQL スキーマルートタイプのクエリフィールド
graphql_schema_root_type : ルートタイプ（クエリ/ミューテーション）のドキュメントを取得する
graphql_schema_type : 特定のタイプのクエリドキュメント
call_github_graphql : GitHub GraphQL APIクエリを実行する

使用例

MCP クライアントを使用してサーバーに接続した後、次の操作を実行できます。

クエリルートタイプのドキュメント:
Use the graphql_schema_root_type tool, parameter type_name="QUERY"
特定のタイプのフィールドをクエリします。
Use the print_type_field tool, parameters type_name="QUERY", type_fields_name="repository"
特定のタイプのクエリドキュメント:
Use the graphql_schema_type tool, parameter type_name="Repository"
GraphQL クエリを実行します。
Use the call_github_graphql tool, parameter: graphql=""" query { viewer { login name } } """

スクリーンショットの例

以下は、Claude と GitHub GraphQL API MCP を使用する例です。

注記

使用する前に、GitHubトークンに適切な権限があることを確認してください。
トークンは.envファイルに保存されますが、バージョン管理システムにコミットしないでください。
クエリはGitHub APIの使用制限に準拠する必要があります

ライセンス

このプロジェクトは、MIT ライセンスに基づいてライセンスされています。これは、著作権表示とライセンスステートメントを保持する限り、ユーザーがこのソフトウェアを自由に使用、変更、配布、および商用化できる、非常に寛容なライセンスです。

詳細な条件についてはMIT ライセンスを参照してください。

GitHub GraphQL API MCP

Integrations