Github Graphql MCP Server

🚀 GitHub GraphQL MCP サーバー

GitHub GraphQL API へのアクセスを提供する Model Context Protocol (MCP) サーバーです。このサーバーは、GitHub の API に対して任意の GraphQL クエリとミューテーションを実行するツールを提供します。

✨ 主な機能

• GitHub API に対する任意の GraphQL クエリを実行できます。
• 包括的なエラー処理とレポート機能が備わっています。
• 詳細なドキュメントとサンプルクエリが付属しています。
• GraphQL 操作での変数の使用をサポートしています。

📦 インストール

前提条件

• Python 3.10 以上
• GitHub 個人アクセストークン (PAT)

インストール手順

1. このリポジトリをクローンします。
2. 仮想環境を設定します（推奨）：

   # macOS/Linux の場合
   python3 -m venv .venv
   source .venv/bin/activate
   
   # Windows の場合
   python -m venv .venv
   .venv\Scripts\activate
   

3. 依存関係をインストールします：

   pip install -r requirements.txt
   

💻 使用例

サーバーの起動

# 仮想環境を使用する場合は、必ずアクティブにしてください
source .venv/bin/activate  # Windows の場合：.venv\Scripts\activate

# GitHub トークンを使用してサーバーを起動します
GITHUB_TOKEN=your_github_token_here python github_graphql_mcp_server.py

Claude Desktop との連携

Claude Desktop の設定ファイルに以下の内容を追加します：

{
  "github-graphql": {
    "command": "/absolute/path/to/your/.venv/bin/python",
    "args": [
        "/absolute/path/to/github_graphql_mcp_server.py"
    ],
    "options": {
        "cwd": "/absolute/path/to/repository"
    },
    "env": {
        "GITHUB_TOKEN": "your_github_token_here"
    }
  }
}

/absolute/path/to/ をサーバーファイルの実際のパスに置き換え、GitHub トークンを追加してください。

サンプルクエリ

リポジトリ情報の取得

query GetRepo($owner: String!, $name: String!) {
  repository(owner: $owner, name: $name) {
    name
    description
    stargazerCount
    url
    createdAt
    owner {
      login
      avatarUrl
    }
  }
}

変数：

{
  "owner": "octocat",
  "name": "Hello-World"
}

リポジトリの検索

query SearchRepos($query: String!, $first: Int!) {
  search(query: $query, type: REPOSITORY, first: $first) {
    repositoryCount
    edges {
      node {
        ... on Repository {
          name
          owner { login }
          description
          stargazerCount
          url
        }
      }
    }
  }
}

変数：

{
  "query": "language:python stars:1000",
  "first": 5
}

ユーザー情報の取得

query GetUserInfo($login: String!) {
  user(login: $login) {
    name
    login
    bio
    avatarUrl
    followers {
      totalCount
    }
    repositories(first: 5, orderBy: {field: STARGAZERS, direction: DESC}) {
      nodes {
        name
        description
        stargazerCount
      }
    }
  }
}

変数：

{
  "login": "octocat"
}

🔧 技術詳細

GitHub API レート制限

GitHub の API レート制限に注意してください：

• 認証済みのリクエスト：1 時間あたり 5,000 リクエスト
• 未認証のリクエスト：1 時間あたり 60 リクエスト

トラブルシューティング

問題が発生した場合は、以下のことを確認してください：

1. GitHub トークンに正しい権限が付与されていることを確認します。
2. 仮想環境が正しく設定され、アクティブになっていることを確認します。
3. トークンが環境変数に正しく設定されていることを確認します。
4. Claude Desktop を使用する場合は、Python のパスが正しいことを確認します（仮想環境の Python の絶対パスを使用）。
5. サーバーログのエラーメッセージを確認します。
6. GraphQL クエリが GitHub のスキーマと有効であることを確認します。
7. 設定を変更した後は、Claude Desktop を再起動します。

一般的なエラーと解決策

spawn python ENOENT

• このエラーは、Python 実行ファイルが見つからないことを示します。
• 解決策：仮想環境の Python 実行ファイルの絶対パスを使用します（例：/path/to/your/.venv/bin/python）。

ModuleNotFoundError: No module named 'httpx' (または他のパッケージ)

• 解決策：pip install -r requirements.txt を実行して、欠落している依存関係をインストールします。

GITHUB_TOKEN 不可为空 または類似のエラー

• 環境変数に有効な GitHub トークンが設定されていることを確認します。