MCP GitHub Repository Server

MCP GitHub リポジトリサーバー

GitHub リポジトリのコンテンツにアクセスできる MCP（Model Context Protocol）サーバーです。このサーバーを使うと、AI アシスタントが指定した GitHub リポジトリのファイルを閲覧および読み取ることができます。

デモ

機能

リソース

• URI を介して GitHub リポジトリ内の任意のファイルにアクセス
• リポジトリのコンテンツを一覧表示し、ディレクトリを移動
• ブランチを指定したファイルアクセスに対応
• ファイルのコンテンツをプレーンテキストとして提供

リソース URI

• ベース URL の形式：https://api.github.com/repos/{owner}/{repo}/contents/{path}
• ファイルとディレクトリの両方に対応
• ファイルは MIME タイプ text/plain で提供
• ディレクトリは MIME タイプ application/x-directory で提供

設定

サーバーには、次の環境変数が必要です。

GITHUB_PERSONAL_ACCESS_TOKEN=your_github_token
GITHUB_OWNER=repository_owner
GITHUB_REPO=repository_name
GITHUB_BRANCH=branch_name  # Optional

開発

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

npm install

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

npm run build

自動再ビルドを有効にして開発する場合：

npm run watch

インストール

Claude Desktop で使用するには、サーバー設定を追加します：

設定ファイルの場所

• MacOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-server-github-repo": {
      "command": "/path/to/mcp-server-github-repo/build/index.js"
    }
  }
}

API の実装

サーバーは、次の 2 つの主要な MCP エンドポイントを実装します：

1. ListResources - リポジトリ内のファイルとディレクトリを一覧表示します
2. ReadResource - 指定されたファイルのコンテンツを取得します

認証

サーバーは GitHub Personal Access Token を使用して認証します。リポジトリのコンテンツへのアクセスに必要な権限がトークンに付与されていることを確認してください。

エラー処理

サーバーは次のエラーを処理します：

• 環境変数の不足
• GitHub API エラー
• 無効なパス（例：ディレクトリをファイルとして読み込もうとした場合）
• 認証エラー

デバッグ

MCP サーバーは標準入出力経由で通信するため、デバッグが難しい場合があります。デバッグには MCP Inspector を使用してください：

npm run inspector

ブラウザーでデバッグツールにアクセスするための URL が表示されます。

セキュリティに関する注意事項

• GitHub Personal Access Token は安全に保管してください
• 必要最小限の権限を付与したトークンの使用を検討してください
• 大規模なリポジトリにアクセスする場合は、リポジトリサイズの制限に注意してください

ライセンス

MIT