GitHub Repo MCP

GitHub Repo MCP

GitHub Repo MCP は、AI アシスタントから GitHub リポジトリの閲覧、ディレクトリの確認、ファイル内容の表示ができるオープンソースの MCP サーバーです。

目次

はじめに • 機能の概要

✨ 主な機能

• 💻 stdio プロトコルに対応する Cursor、Windsurf、Claude Desktop、その他の MCP クライアントと互換性があります
• 🔎 任意の公開 GitHub リポジトリの内容を閲覧できます
• 📂 リポジトリのディレクトリやサブディレクトリを移動できます
• 📝 コードファイルやテキストファイルの内容を表示できます
• 📦 パッケージマネージャーから簡単にインストールできます

はじめに

前提条件

サーバーをインストールするには、システムに以下が必要です。

• Node.js 18+
• npm または yarn

ステップ 1. インストール

Smithery、NPX、または IDE の mcp.json を設定して、GitHub Repo MCP をインストールして実行できます。

MacOS

npx github-repo-mcp

Windows NPX

cmd /c npx -y github-repo-mcp

.cursor/mcp.json を使用した Windows NPX

{
  "mcpServers": {
    "github-repo-mcp": {
      "command": "wsl",
      "args": [
        "bash",
        "-c",
        "cmd /c npx -y github-repo-mcp"
      ],
      "enabled": true
    }
  }
}

.cursor/mcp.json を使用した Windows NPX（パスが設定されていない場合）

# Find the full path to npx first
which npx

{
  "mcpServers": {
    "github-repo-mcp": {
      "command": "wsl",
      "args": [
        "bash",
        "-c",
        "'/home/[username]/.nvm/versions/node/v20.18.0/bin/npx github-repo-mcp'"
      ],
      "enabled": true
    }
  }
}

Smithery を使用したインストール

Smithery を使って、Claude Desktop 用の GitHub Repo MCP を自動的にインストールするには、以下を実行します。

npx -y @smithery/cli install @Ryan0204/github-repo-mcp --client claude

登録されない場合は、数秒待つか、更新ボタンを数回クリックしてください。それでも登録されない場合は、コマンドが正しく入力されていることを確認してください。

ステップ 2. 設定

GitHub Repo MCP サーバーでは、GitHub API へのアクセス時にレート制限を緩和するため、GitHub トークンを使用できます。

環境変数

変数	必須	デフォルト	説明
GITHUB_TOKEN	いいえ	なし	レート制限を緩和するための GitHub 個人用アクセストークン

GitHub トークンの設定（任意）

サーバーは認証なしでも動作しますが、GitHub API のレート制限は未認証リクエストの場合、かなり厳しくなります。レート制限を緩和するには、以下を行います。

1. https://github.com/settings/tokens で個人用アクセストークンを作成します
2. mcp.json でトークンを環境変数として設定します。

{
  "mcpServers": {
    "github-repo-mcp": {
      "command": "...",
      "args": [
        ...
      ],
      "env": {
        "GITHUB_TOKEN": "Your_Github_Token"
      }
      "enabled": true,
    }
  }
}

機能の概要

リポジトリ閲覧ツール

このサーバーは、GitHub リポジトリを操作するための主なツールを 3 つ提供します。

1. getRepoAllDirectories

GitHub リポジトリのルートにあるすべてのファイルとディレクトリを一覧表示します。

• パラメーター:
  • repoUrl: GitHub リポジトリの URL（例：「https://github.com/owner/repo」）

2. getRepoDirectories

GitHub リポジトリ内の指定したディレクトリの内容を一覧表示します。

• パラメーター:
  • repoUrl: GitHub リポジトリの URL
  • path: 取得するディレクトリのパス（例：「src」）

3. getRepoFile

GitHub リポジトリから指定したファイルの内容を取得して表示します。

• パラメーター:
  • repoUrl: GitHub リポジトリの URL
  • path: 取得するファイルのパス（例：「src/index.js」）

使用例

AI アシスタントでこれらのツールを使用する方法をいくつか紹介します。

1. リポジトリのルートを閲覧する: AI アシスタントに「https://github.com/Ryan0204/github-repo-mcp のリポジトリの内容を表示して」と依頼します。

2. 特定のディレクトリを確認する: 「https://github.com/Ryan0204/github-repo-mcp の src ディレクトリにはどのファイルがありますか？」と尋ねます。

3. ファイルを表示する: 「https://github.com/Ryan0204/github-repo-mcp の README.md ファイルを表示して」と尋ねます。

制限事項

• レート制限：認証なしの場合、GitHub APIには厳しいレート制限があります（1時間あたり60リクエスト）
• プライベートリポジトリ：適切な権限を持つトークンが提供されない限り、アクセスできるのは公開リポジトリのみです
• バイナリファイル：サーバーは一般的なバイナリファイルの拡張子を検出し、その内容を表示しません
• 大きなファイル：GitHub APIには、取得できるファイルのサイズに制限があります

トラブルシューティング

よくある問題と解決方法を以下に示します。

• レート制限を超過した：設定セクションの説明に従って、GitHub トークンを設定してください
• コマンドが見つからない：パッケージがグローバルにインストールされていることを確認してください
• 接続エラー：インターネット接続と GitHub API のステータスを確認してください

問題が発生した場合は、エラーメッセージが出力されていないか確認するか、GitHub リポジトリにイシューを作成してください。

---

お楽しみください！☺️