GitHub MCP Server (Official)

GitHub MCP Server (Official) とは？

GitHub MCP server は、AI エージェントが自然言語でリポジトリやコードを読み、issue と pull request を管理し、GitHub Actions の実行状況やセキュリティアラートを確認できるようにする、GitHub 公式の Model Context Protocol サーバーです。GitHub がホストするリモートサーバーとしても、Docker を使ってローカルでも実行できます。

GitHub がオープンソースのリポジトリ github/github-mcp-server で MIT ライセンスのもと管理しています。ホスト型エンドポイントは https://api.githubcopilot.com/mcp/ で、ローカル版は公開イメージ ghcr.io/github/github-mcp-server とリリースバイナリとして提供されています。

GitHub MCP Server (Official) の使い方

次の 2 つのモードから選びます。

• リモート（GitHub がホスト）：リモートサーバーに対応した MCP ホスト（README には VS Code 1.101+、Claude Desktop、Cursor、Windsurf などが記載）と、該当する組織ポリシーの有効化が必要です。
• ローカル：Docker をインストールして起動しておくか、go build でビルドしたバイナリ、または releases ページからダウンロードしたバイナリを使います。

認証は GitHub OAuth（ブラウザでのフロー。トークンはメモリ上にのみ保持）か、GITHUB_PERSONAL_ACCESS_TOKEN に設定する GitHub Personal Access Token（PAT）で行い、PAT が OAuth より優先されます。トークンは github.com/settings/personal-access-tokens/new で作成し、必要なスコープだけを付与してください。

Claude Code

リモートサーバー（Claude Code 2.1.1 以降）の場合、ターミナルで次を実行します。

claude mcp add-json github '{"type":"http","url":"https://api.githubcopilot.com/mcp","headers":{"Authorization":"Bearer YOUR_GITHUB_PAT"}}'

Docker と PAT を使うローカルサーバーの場合：

claude mcp add github -e GITHUB_PERSONAL_ACCESS_TOKEN=YOUR_GITHUB_PAT -- docker run -i --rm -e GITHUB_PERSONAL_ACCESS_TOKEN ghcr.io/github/github-mcp-server

Claude Code を再起動し、claude mcp list でサーバーが設定されたことを確認します。

Claude Desktop

GitHub のガイドによると、リモートサーバーの OAuth フローは現在 Claude Desktop のカスタムコネクタではサポートされていないため、claude_desktop_config.json でローカルの Docker 構成を使います。

{
  "mcpServers": {
    "github": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "GITHUB_PERSONAL_ACCESS_TOKEN", "ghcr.io/github/github-mcp-server"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "YOUR_GITHUB_PAT"
      }
    }
  }
}

Cursor

Cursor v0.48.0 以降はホスト型サーバーを利用できます。次の内容を ~/.cursor/mcp.json（またはプロジェクトの .cursor/mcp.json）に追加し、Cursor を再起動します。

{
  "mcpServers": {
    "github": {
      "url": "https://api.githubcopilot.com/mcp/",
      "headers": {
        "Authorization": "Bearer YOUR_GITHUB_PAT"
      }
    }
  }
}

VS Code

README のワンクリックインストールボタンを使うか、リモートサーバーを手動で追加し（VS Code 1.101 以降は OAuth を自動で処理）、Copilot Chat で Agent モードに切り替えます。

{
  "servers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/"
    }
  }
}

Codex

~/.codex/config.toml を編集します。

[mcp_servers.github]
url = "https://api.githubcopilot.com/mcp/"
bearer_token_env_var = "GITHUB_PAT_TOKEN"

Copilot CLI、JetBrains、Visual Studio、Eclipse、Xcode、Windsurf、Zed、OpenCode、Gemini CLI、Rovo Dev CLI 向けのインストールガイドも用意されています。

GitHub MCP Server (Official) の主な機能

• GitHub 公式プロジェクトで、ホスト型リモートサーバーとローカルの Docker またはバイナリの両方を提供。
• OAuth ログインまたは Personal Access Token による認証。
• ツールセット：--toolsets または GITHUB_TOOLSETS で必要な機能グループだけを有効化（デフォルトは context、repos、issues、pull_requests、users。all ですべて有効）。
• --tools / GITHUB_TOOLS で個別のツールを選択でき、単独でもツールセットと組み合わせても使用可能。
• 読み取り専用モード（--read-only または GITHUB_READ_ONLY=1）は読み取り系ツールのみを公開。
• ロックダウンモード（--lockdown-mode）は、公開リポジトリでプッシュ権限のない作成者のコンテンツを除外し、プロンプトインジェクションのリスクを低減。
• --gh-host / GITHUB_HOST で GitHub Enterprise Server と ghe.com に対応。
• Insiders モードで実験的なツールを先行利用可能。

GitHub MCP Server (Official) のツール

ツールは GitHub の製品領域に対応したツールセットにまとめられています。

• コンテキストとユーザー：get_me、get_teams、search_users で、エージェントがどのアカウントとして動作しているかを把握します。GitHub は context を「強く推奨」としています。
• リポジトリと Git：get_file_contents、search_code、list_commits、create_branch、create_or_update_file、push_files、fork_repository、get_repository_tree でコードの閲覧と変更を行います。
• Issue と pull request：list_issues、issue_read、issue_write、search_issues、create_pull_request、pull_request_read、pull_request_review_write、merge_pull_request でトリアージ、レビュー、マージをカバーします。
• Actions：actions_list、actions_get、actions_run_trigger、get_job_logs でワークフロー実行を確認・トリガーします。
• セキュリティ：コードスキャン、Dependabot、シークレットスキャン、セキュリティアドバイザリのツール（list_code_scanning_alerts、list_dependabot_alerts など）。
• コラボレーション：discussions、通知、projects、gists、ラベル、stargazers、組織関連のツール。
• リモート限定：create_pull_request_with_copilot（Copilot coding agent）、Copilot Spaces、github_support_docs_search。

GitHub MCP Server (Official) のユースケース

• コード探索：「このリポジトリでレートリミッターが実装されている場所を見つけて、仕組みを説明して」
• Issue のトリアージ：「先週 bug ラベルが付いた未解決の issue を一覧にして、重複をまとめて」
• Pull request のレビュー：「PR 42 の diff を読んで、リスクのある変更を指摘し、レビューコメントを残して」
• CI のデバッグ：「main で最新のワークフロー実行が失敗したのはなぜ？失敗したジョブのログを見せて」
• セキュリティレビュー：「このリポジトリの未対応の Dependabot アラートとコードスキャンアラートを重大度順に一覧にして」
• 作業の委任：リモートサーバーで、説明したタスクについて Copilot coding agent に pull request を作成させる。

GitHub MCP Server (Official) と代替ツールの比較

• 公式版と以前のコミュニティ版・リファレンス実装：MCP servers リポジトリにあった以前の GitHub リファレンスサーバー（Github MCP Server）と npm パッケージ @modelcontextprotocol/server-github はサポートが終了しており、GitHub のドキュメントは ghcr.io/github/github-mcp-server への移行を案内しています。cyanheads/github-mcp-server などのコミュニティプロジェクトも非推奨となり、公式サーバーを推奨しています。
• リモートとローカル：リモートサーバーは Docker 不要で追加のツールセットがあり、ローカルサーバーはリモート MCP に対応していないホストや GitHub Enterprise Server で利用できます。
• 他のコードホスティング：コードを GitLab で管理している場合は GitLab MCP Server を参照してください。

GitHub MCP Server (Official) のトラブルシューティング

• Docker イメージの pull に失敗する：イメージは公開されています。期限切れのトークンが原因で失敗することがあるため、docker logout ghcr.io を実行してから再試行してください。
• Cursor でリモートサーバーに接続できない：Streamable HTTP に対応した Cursor v0.48.0 以降を使っていること、PAT が有効で正しいスコープを持つことを確認してください。
• claude mcp add-json が「Invalid input」を返す（Windows で報告あり）：従来の形式 claude mcp add --transport http github https://api.githubcopilot.com/mcp -H "Authorization: Bearer YOUR_GITHUB_PAT" を使ってください。
• --tools を設定した後にサーバーが起動しない：ツール名は完全に一致する必要があります（例：get_file_contents）。無効な名前があるとサーバーは起動しません。
• 書き込み系ツールが表示されない：読み取り専用モードでは、--tools に指定していても書き込み系ツールはスキップされます。