GitHub MCP サーバーの使用

GitHub MCP サーバーについて

GitHub MCP サーバーとは、GitHub によって提供および管理されるモデル コンテキスト プロトコル (MCP) サーバーです。 MCP を使うと、AI 機能を他のツールやサービスと統合し、コンテキスト対応の AI 支援を提供することで開発エクスペリエンスを強化できます。

MCP の詳細については、MCP 公式ドキュメントを参照してください。

GitHub MCP サーバーは、Visual Studio Code やリモート MCP をサポートする他のエディターを介してリモートでアクセスすることも、MCP と互換性のある任意のエディターを使ってローカル環境で実行することもでき、ホストされたソリューションの便利さと、セルフホステッド セットアップのカスタマイズしやすさのいずれかを選択できます。

リモートの GitHub MCP サーバーを利用する場合は、ローカル環境を設定することなく、数ステップで行うことができます。 これは、ローカル MCP サーバーを管理するオーバーヘッドなしに、GitHub の AI 機能をすぐにでも活用したいユーザーに特に便利です。

GitHub MCP サーバーをローカル環境で実行すると、さらに多くのセットアップが必要ですが、AI の対話をカスタマイズして制御できる範囲が広がります。

GitHub MCP サーバーを使うと次のことができます。

• コード関連のタスクを自動化および効率化します。
• サードパーティのツール (Cursor、Windsurf、将来の統合など) を接続して、GitHub のコンテキストと AI の機能を活用します。
• ローカル環境を設定しないで、任意のデバイスから動作するクラウドベースのワークフローを有効にします。

可用性

現在、Visual Studio Code、JetBrains IDE、XCode、その他のクライアントで、ローカル MCP サーバーが幅広くサポートされています。

リモート MCP サーバーのサポートは増えており、Visual Studio Code (OAuth または PAT を使用)、Visual Studio (PAT のみ)、Windsurf (PAT のみ)、Cursor (PAT のみ) などのエディターでこの機能が既に提供されています。

好みのエディターでリモート MCP サーバーがサポートされているかどうかを調べるには、特定のエディターのドキュメントを確認してください。

前提条件

• GitHub アカウント。
• Visual Studio Code または別の MCP 互換エディター。

Visual Studio Code での GitHub MCP サーバーの設定

以下では、Visual Studio Code で GitHub MCP サーバーを設定する手順を見ていきます。 他の MCP 互換エディターでは、手順は似ていることがありますが、正確なプロセスは異なる場合があります。

ニーズとユーザー設定に応じて、GitHub MCP サーバーをリモートまたはローカルで設定できます。 次のいずれかを対象に GitHub MCP サーバーを構成することもできます。

• 特定のリポジトリ。 これにより、Visual Studio Code でプロジェクトを開いたすべてのユーザーと MCP サーバーを共有できます。 これを行うには、リポジトリのルートに .vscode/mcp.json ファイルを作成します。
• Visual Studio Code の個人インスタンス。 構成した MCP サーバーにアクセスできるのは自分だけです。 これを行うには、Visual Studio Code で settings.json ファイルに構成を追加します。 この方法で構成された MCP サーバーは、すべてのワークスペースで使用できます。

リモート GitHub MCP サーバーでは、ワンクリック OAuth 認証が既定で使われますが、personal access token (PAT) を認証に使うように手動で構成することもできます。 OAuth を使う場合、MCP サーバーのアクセス権は個人用アカウントと同じになります。 PAT を使う場合、MCP サーバーのアクセス権は PAT によって許可されるスコープになります。

• OAuth を使用するリモート MCP サーバーの構成
• PAT を使用するリモート MCP サーバーの構成
• ローカル MCP サーバーのセットアップ

OAuth を使用するリモート MCP サーバーの構成

リモート GitHub MCP サーバーを OAuth で使うために、PAT を作成したり、追加のソフトウェアをインストールしたりする必要はありません。 Visual Studio Code で直接設定できます。 また、個々のツールセットを、読み取り専用モードまたは完全な読み取り/書き込みアクセス権限でインストールすることもでき、サーバーの機能を特定のニーズに合わせて調整できます。 詳しくは、「ツールの構成」をご覧ください。

1. Visual Studio Code で、Ctrl + Shift + P キー (Windows/Linux) または Command + Shift + P キー (Mac) を押して、コマンド パレットを開きます。

2. 「mcp: add server」と入力して Enter キーを押します。

3. 一覧から [HTTP (HTTP またはサーバー送信イベント)] を選びます。

4. [サーバー URL] フィールドに「https://api.githubcopilot.com/mcp/」と入力して Enter キーを押します。

5. [サーバー ID の入力] で、Enter キーを押して既定のサーバー ID を使うか、カスタム サーバー ID を入力します。

6. [構成を保存する場所を選択する] で、MCP サーバーの構成を保存する場所を選びます。

   • Visual Studio Code により、選んだファイルがエディターで開かれて構成が追加されるか、存在しない場合は新しいファイルが作成されます。

7. Visual Studio Code のポップアップで、OAuth を使って MCP サーバーを認可するには、[許可] をクリックして、一覧から個人用アカウントを選びます。

PAT を使用するリモート MCP サーバーの構成

PAT を使ってリモート GitHub MCP サーバーを構成するには、MCP サーバーに許可するアクセス権に必要なスコープで PAT が作成されていることを確認します。 詳しくは、「個人用アクセス トークンを管理する」をご覧ください。

認可に PAT を使うには、Visual Studio Code で MCP サーバーを手動で構成する必要があります。

1. Visual Studio Code で、Ctrl + Shift + P キー (Windows/Linux) または Command + Shift + P キー (Mac) を押して、コマンド パレットを開きます。

2. 「mcp: add server」と入力して Enter キーを押します。

3. 一覧から [HTTP (HTTP またはサーバー送信イベント)] を選びます。

4. [サーバー URL] フィールドに「https://api.githubcopilot.com/mcp/」と入力して Enter キーを押します。

5. [サーバー ID の入力] で、Enter キーを押して既定のサーバー ID を使うか、カスタム サーバー ID を入力します。

6. [構成を保存する場所を選択する] で、MCP サーバーの構成を保存する場所を選びます。

   • Visual Studio Code により、選んだファイルがエディターで開かれて構成が追加されるか、存在しない場合は新しいファイルが作成されます。

7. Visual Studio Code のポップアップで、OAuth の認可を拒否するには、[キャンセル] をクリックします。

8. PAT を使うには、構成ファイルを手動で編集する必要があります。 構成ファイルで、url 行の最後に次のコードを追加します。

   JSON

       ,
         "headers": {
           "Authorization": "Bearer ${input:github_token}"
         }
       },
     },
     "inputs": [
       {
         "id": "github_token",
         "type": "promptString",
         "description": "GitHub Personal Access Token",
         "password": true
       }
     ]
   }
   

9. ファイルで [Restart] ボタンが表示されます。 [Restart] をクリックし、新しい構成で MCP サーバーを再起動します。

   

10. コマンド パレットに、GitHub トークンの入力を求めるプロンプトが表示されます。 先ほど作成した PAT を入力して、Enter キーを押します。

    • 認可に PAT を使うように MCP サーバーが構成されます。

ローカル MCP サーバーのセットアップ

GitHub MCP サーバーをローカル環境で使うには、Docker をコンピューターにインストールして実行する必要があります。 また、ローカル MCP サーバーでは OAuth がサポートされていないため、認可には PAT のみを使用できます。

1. お使いのコンピューターに Docker がインストールされ、実行されていることを確認します。 Docker のインストール手順に関するページを参照してください。

2. スコープが (少なくとも) read:packages と repo に設定された PAT を作成します。 詳しくは、「個人用アクセス トークンを管理する」をご覧ください。

3. MCP サーバーの構成対象を特定のリポジトリにするか、Visual Studio Code の個人用インスタンスにするかを決めます。

   • 特定のリポジトリをお使いの場合は、Visual Studio Code で .vscode/mcp.json ファイルを開き、次の構成を追加します。
   JSON

      {
       "inputs": [
         {
           "type": "promptString",
           "id": "github_token",
           "description": "GitHub Personal Access Token",
           "password": true
         }
       ],
       "servers": {
         "github": {
           "command": "docker",
           "args": [
             "run",
             "-i",
             "--rm",
             "-e",
             "GITHUB_PERSONAL_ACCESS_TOKEN",
             "ghcr.io/github/github-mcp-server"
           ],
           "env": {
             "GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github_token}"
           }
         }
       }
     }
   

   • Visual Studio Code の個人用インスタンスをお使いの場合は、Visual Studio Code で settings.json ファイルを開きます。
     • Ctrl+Shift+P キー (Windows/Linux) または Cmd+Shift+P キー (macOS) を押します。
     • 「Preferences: Open Settings (JSON)」と入力して、それを選びます。
     • 次の構成を追加します。
   JSON

   {
     "mcp": {
       "inputs": [
         {
           "type": "promptString",
           "id": "github_token",
           "description": "GitHub Personal Access Token",
           "password": true
         }
       ],
       "servers": {
         "github": {
           "command": "docker",
           "args": [
             "run",
             "-i",
             "--rm",
             "-e",
             "GITHUB_PERSONAL_ACCESS_TOKEN",
             "ghcr.io/github/github-mcp-server"
           ],
           "env": {
             "GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github_token}"
           }
         }
       }
     }
   }
   

4. ファイルを保存します。

5. コマンド パレットに、GitHub トークンの入力を求めるプロンプトが表示されます。 先ほど作成した PAT を入力して、Enter キーを押します。

   • 認可に PAT を使ってローカル環境で実行するように MCP サーバーが構成されます。

ツールの設定

GitHub MCP サーバーでは、個々のツールセットを、読み取り専用モードまたは完全な読み取り/書き込みアクセス権限でインストールすることがサポートされており、サーバーの機能を特定のニーズに合わせて調整できます。 各ツールセットのワンクリック インストール オプションについては、GitHub MCP サーバーのリポジトリを参照してください。

Visual Studio Code での GitHub MCP サーバーの使用

GitHub MCP サーバーを使うと、Visual Studio Code の Copilot Chat を介して、GitHub でさまざまなアクションを実行できます。

1. Visual Studio Code のタイトル バーの アイコンをクリックして、Copilot Chat を開きます。
2. Copilot Chat ボックスで、ポップアップ メニューから [Agent] を選びます。
3. 使用できるアクションを表示するには、Copilot Chat ボックスの [Select tools] アイコンをクリックします。
   • [Tools] ドロップダウンの [MCP Server:GitHub] の下に、使用できるアクションの一覧が表示されます。
4. Copilot Chat ボックスに、実行するアクションに関連するコマンドまたは質問を入力して、Enter キーを押します。
   • たとえば、新しい issue の作成、pull request の一覧表示、リポジトリの情報の取得を、GitHub MCP サーバーに依頼できます。
5. GitHub MCP サーバーによって要求が処理されて、チャット インターフェイスで応答が提供されます。
   • Copilot Chat ボックスでは、アクションを完了するために、追加のアクセス許可の付与または詳細情報の指定を求められる場合があります。
6. プロンプトに従ってアクションを完了します。

トラブルシューティング

GitHub MCP サーバーの使用中に問題が発生した場合は、いくつかの一般的なトラブルシューティング手順を実行できます。

承認の問題

MCP サーバーの認可で問題が発生した場合は、次のことを確認します。

• 任意の IDE で GitHub にサインインしています。

personal access token (PAT) で認証を行っている場合は、次のことを確認します。

• GitHub の PAT が有効であり、実行するアクションに必要なスコープを持っています。
• Visual Studio Code で求められたときに、正しい PAT を入力しています。

Copilot エージェント モードの問題

Copilot Chat エージェント モードで問題が発生した場合は、次のことを確認します。

• Copilot Chat ボックスで適切なエージェントを選択しています。
• Visual Studio Code で MCP サーバーを正しく構成してあります。
• 実行しようとしているアクションを実行するために必要なアクセス許可があります。

一般的なヒント

GitHub MCP サーバーで他の問題が発生する場合のトラブルシューティングに役立つ一般的なヒントを次に示します。

• MCP サーバーの出力ログでエラー メッセージを調べます。
• MCP サーバーをローカル環境で実行している場合は、ローカル環境が Docker コンテナーの実行用に正しく設定されていることを確認します。
• MCP サーバーまたは IDE を再起動してみます。

参考資料

• モデル コンテキスト プロトコル (MCP) を使用した Copilot コーディング エージェントの拡張