MCP GitHub リポジトリサーバー

GitHubリポジトリのコンテンツへのアクセスを提供するMCP（Model Context Protocol）サーバー。このサーバーにより、AIアシスタントは指定されたGitHubリポジトリからファイルを参照および読み取ることができます。

デモ

Related MCP server: GitHub MCP Server

特徴

リソース

• URI経由でGitHubリポジトリ内の任意のファイルにアクセスする

• リポジトリの内容を一覧表示し、ディレクトリをナビゲートする

• ブランチ固有のファイルアクセスのサポート

• ファイルの内容はプレーンテキストとして提供されます

リソースURI

• ベース URL 形式: https://api.github.com/repos/{owner}/{repo}/contents/{path}

• ファイルとディレクトリの両方をサポート

• ファイルはtext/plain MIMEタイプで提供されます

• ディレクトリはapplication/x-directory MIME タイプで提供されます。

構成

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

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実装

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

1. ListResources - リポジトリ内のファイルとディレクトリを一覧表示します

2. ReadResource - 特定のファイルの内容を取得します

認証

サーバーは認証にGitHubパーソナルアクセストークンを使用します。トークンにリポジトリのコンテンツにアクセスするための適切な権限があることを確認してください。

エラー処理

サーバーには次のエラー処理が含まれています:

• 環境変数が見つかりません

• GitHub APIエラー

• 無効なパス（例：ディレクトリをファイルとして読み取ろうとする）

• 認証失敗

デバッグ

MCPサーバーはstdio経由で通信するため、デバッグが困難になる場合があります。デバッグにはMCPインスペクターを使用してください。

npm run inspector

これにより、ブラウザでデバッグ ツールにアクセスするための URL が提供されます。

セキュリティノート

• GitHub 個人アクセストークンを安全に保つ

• 必要最小限の権限を持つトークンの使用を検討する

• 大規模なリポジトリにアクセスする場合は、リポジトリのサイズ制限に注意してください。

ライセンス

マサチューセッツ工科大学