Github MCP Server

Github MCP サーバー

Github 用の Model Context Protocol サーバーです。

MCP を通じて Github と連携し、LLM が Github を操作できるようにします。

Github REST API ドキュメント

インストール

手動インストール

1. Github アカウントのアクセストークンを作成するか、取得します：ガイド

2. Claude Desktop にサーバー設定を追加します：

   • MacOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：こちらのガイドを確認してください

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "github-mcp-server"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your_personal_github_access_token"
      }
    }
  }
}

コンポーネント

ツール

1. search_repositories：GitHub でリポジトリを検索します。

   • 必須入力：
     • query（string）：リポジトリの検索クエリです。
     • page（number、デフォルト：30、最大：100）：ページネーション用のページ番号です。
     • per_page（number、デフォルト：30、最大：100）：1 ページあたりの結果数です。

2. search_issues：リポジトリのイシューを検索します。

   • 必須入力：
     • query（string）：リポジトリの検索クエリです。
     • page（number、デフォルト：1）：ページネーション用のページ番号です。
     • per_page（number、デフォルト：30、最大：100）：1 ページあたりの結果数です。
     • order（省略可能な string、デフォルト：desc）：並び順（asc または desc）です。
     • sort（省略可能な string、デフォルト：best match）：並べ替えの基準となるフィールドです（comments、reactions、reactions-+1、reactions--1、reactions-smile、reactions-thinking_face、reactions-heart、reactions-tada、interactions、created または updated のいずれか）。

3. search_commits：リポジトリのコミットを検索します。

   • 必須入力：
     • query（string）：リポジトリの検索クエリです。
     • page（number、デフォルト：1）：ページネーション用のページ番号です。
     • per_page（number、デフォルト：30、最大：100）：1 ページあたりの結果数です。
     • order（省略可能な string、デフォルト：desc）：並び順（asc または desc）です。
     • sort（省略可能な string、デフォルト：best match）：並べ替えの基準となるフィールドです（committer-date または author-date のいずれか）。

4. search_code：リポジトリ内のコードを検索します。

   • 必須入力：
     • query（string）：リポジトリの検索クエリです。
     • page（number、デフォルト：1）：ページネーション用のページ番号です。
     • per_page（number、デフォルト：30、最大：100）：1 ページあたりの結果数です。

5. search_users：リポジトリのユーザーを検索します。

   • 必須入力：
     • query（string）：リポジトリの検索クエリです。
     • page（number、デフォルト：1）：ページネーション用のページ番号です。
     • per_page（number、デフォルト：30、最大：100）：1 ページあたりの結果数です。
     • order（省略可能な string、デフォルト：desc）：並び順（asc または desc）です。
     • sort（省略可能な string、デフォルト：best match）：並べ替えの基準となるフィールドです（followers、repositories または joined のいずれか）。

6. search_topics：トピックを検索します。

   • 必須入力：
     • query（string）：リポジトリの検索クエリです。
     • page（number、デフォルト：1）：ページネーション用のページ番号です。
     • per_page（number、デフォルト：30、最大：100）：1 ページあたりの結果数です。

7. search_labels：リポジトリ内のラベルを検索します。

   • 必須入力：
     • query（string）：リポジトリの検索クエリです。
     • page（number、デフォルト：1）：ページネーション用のページ番号です。
     • per_page（number、デフォルト：30、最大：100）：1 ページあたりの結果数です。
     • order（省略可能な string、デフォルト：desc）：並び順（asc または desc）です。
     • sort（省略可能な string、デフォルト：best match）：並べ替えの基準となるフィールドです（created または updated のいずれか）。

8. list_repositories_issues：リポジトリのイシューを一覧表示します。

   • 必須入力：
     • owner（string）：リポジトリの所有者。
     • repo（string）：リポジトリ名。
     • page（任意の number、デフォルト：1）：ページネーションのページ番号。
     • per_page（任意の number、デフォルト：30、最大：100）：1ページあたりの結果数。
     • direction（任意の string、デフォルト：desc）：並べ替えの順序（asc または desc）。
     • sort（任意の string、デフォルト：created）：並べ替えフィールド（created、comments、updated のいずれか）。
     • since（任意の string）：指定した時刻以降に最終更新された結果（ISO 8601 形式：YYYY-MM-DDTHH:MM:SSZ.）。
     • labels（任意の string）：カンマ区切りのラベル名。例：bug,ui,@high。
     • milestone（任意の string）：マイルストーン番号。
     • assignee（任意の string）：担当ユーザー名（すべてを対象にする場合は *）。
     • creator（任意の string）：イシューを作成したユーザー。（すべてを対象にする場合は *）。
     • mentioned（任意の string）：イシュー内でメンションされているユーザー。

9. get_issue：リポジトリからイシューを取得します。

   • 必須入力：
     • owner（string）：リポジトリの所有者。
     • repo（string）：リポジトリ名。
     • issue_number（number）：イシュー番号。

10. list_repositories_pull_requests：リポジトリのプルリクエストを一覧表示します。

    • 必須入力：
      • owner（string）：リポジトリの所有者。
      • repo（string）：リポジトリ名。
      • page（任意の number、デフォルト：1）：ページネーションのページ番号。
      • per_page（任意の number、デフォルト：30、最大：100）：1ページあたりの結果数。
      • direction（任意の string、デフォルト：desc）：並べ替えの順序（asc または desc）。
      • sort（任意の string、デフォルト：created）：並べ替えフィールド（created、popularity、long-running、updated のいずれか）。
      • head（任意の string）：head ユーザーまたは head 組織とブランチ名でプルリクエストを絞り込みます。形式は user:ref-name または organization:ref-name です（例：github:new-script-format または octocat:test-branch）。
      • base（任意の string）：ベースブランチ名でプルリクエストを絞り込みます。（例：gh-pages）。

11. get_pull_request：リポジトリからプルリクエストを取得します。

    • 必須入力：
      • owner（string）：リポジトリの所有者。
      • repo（string）：リポジトリ名。
      • pull_request_number（number）：プルリクエスト番号。

使用例

Github とやり取りするために使用できるプロンプトの例：

1. 「modelcontextprotocol」→ search_repositories ツールを実行して、modelcontextprotocol が言及されているリポジトリを検索します。
2. 「modelcontextprotocol servers リポジトリの 739 番のイシューは何ですか」→ get_issue ツールを実行して、modelcontextprotocol servers リポジトリの 739 番のイシューを取得します。
3. 「modelcontextprotocol servers リポジトリの 717 番の PR は何ですか」→ get_pull_request ツールを実行して、modelcontextprotocol servers リポジトリの 717 番の PR を取得します。

開発

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

pnpm install

2. .env で Github アクセストークンを設定します：

GITHUB_PERSONAL_ACCESS_TOKEN=<your_personal_github_access_token>

3. ウォッチモードでローカル実行します：

pnpm dev

4. サーバーをビルドします：

pnpm build

5. インスペクターを使ってローカルでデバッグします：

pnpm inspector