GitHub MCP Server Setup Guide

GitHub MCP サーバーのセットアップガイド

このリポジトリでは、AI 支援開発ワークフロー向けに GitHub Model Context Protocol（MCP）サーバーをセットアップして使用する方法を紹介します。

MCP とは？

Model Context Protocol（MCP）を使用すると、AI アシスタントは標準化されたインターフェースを通じて外部システムや API と連携できます。GitHub MCP サーバーを使うと、AI モデルは次のような GitHub 操作を実行できます。

• リポジトリの作成と管理
• ファイルとコンテンツの管理
• issue とプルリクエストの操作
• リポジトリ情報へのアクセス
• その他！

セットアップ手順

前提条件

• システムに Node.js がインストールされていること
• GitHub アカウント
• 適切な権限を持つ GitHub Personal Access Token（PAT）

手順 1：GitHub Personal Access Token を作成する

1. GitHub の Settings → Developer Settings → Personal Access Tokens に移動します
2. 次の権限を持つ新しいきめ細かいトークンを作成します。
   • Repository：読み取りと書き込み（Administration、Contents、Issues、Pull requests）
   • User：読み取り専用
3. トークンを安全に保存します。設定時に必要になります

手順 2：MCP の設定

1. ユーザーディレクトリに mcp.json という名前の設定ファイルを作成します（例：~/.cursor/mcp.json または C:\Users\YourUsername\.cursor\mcp.json）
2. 次の設定を追加します。

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your_github_pat_here"
      }
    }
  }
}

3. your_github_pat_here を実際の GitHub Personal Access Token に置き換えます

手順 3：MCP サーバーをテストする

1. MCP に対応した互換性のある AI コーディングアシスタント（Cursor など）をインストールします
2. 次のような GitHub 操作をアシスタントに依頼します。
   • リポジトリの作成
   • ファイルの内容の取得
   • issue の作成
   • プルリクエストの作成

使用例

GitHub MCP で実行できる操作の例を紹介します。

• 新しいリポジトリを作成する：Create a new GitHub repository named "my-project"
• リポジトリにコードをプッシュする：Push this file to my repository
• issue を作成する：Create an issue titled "Fix navigation bug" in my repository
• リポジトリの内容を取得する：Show me the contents of the main.js file from my repository

トラブルシューティング

• 権限エラー：GitHub PAT に、実行しようとしている操作に必要な権限があることを確認してください
• 接続の問題：MCP サーバーが正しく設定され、実行中であることを確認してください
• トークンの有効期限切れ：GitHub PAT は有効期限が切れることがあります。新しいトークンを生成する必要があるか確認してください

リソース

• Model Context Protocol（MCP）のドキュメント
• GitHub API のドキュメント
• NPM パッケージ：@modelcontextprotocol/server-github

---

注：GitHub Personal Access Token は常に安全に保管し、公開リポジトリにコミットしないでください。