GitHub MCP サーバーの使用

GitHub MCP サーバーについて

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

GitHub MCP サーバーの詳細内容と MCP の概要については、「About Model Context Protocol (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. プロンプトに従ってアクションを完了します。

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

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

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

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

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

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