MCP Server Github Repo

🚀 MCP GitHub リポジトリサーバー

このサーバーは、MCP（モデルコンテキストプロトコル）を使用して、GitHubリポジトリの内容にアクセスできるようにするものです。AIアシスタントが指定されたGitHubリポジトリ内のファイルを閲覧および読み取ることを可能にします。

🎥 デモ

✨ 主な機能

リソース

• URIを通じてリポジトリ内の任意のファイルにアクセスできます。
• リポジトリの内容を一覧表示し、ディレクトリをナビゲートできます。
• ブランチ固有のファイルアクセスをサポートしています。
• ファイル内容は純粋なテキスト形式で提供されます。

リソースURI

• 基本的なURL形式：https://api.github.com/repos/{owner}/{repo}/contents/{path}
• ファイルとディレクトリの両方をサポートしています。
• ファイルは text/plain MIMEタイプを使用します。
• ディレクトリは application/x-directory MIMEタイプを使用します。

📦 インストール

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"
    }
  }
}

🛠️ 設定

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

GITHUB_PERSONAL_ACCESS_TOKEN=your_github_token
GITHUB_OWNER=repository_owner
GITHUB_REPO=repository_name
GITHUB_BRANCH=branch_name  # オプション

💻 開発

依存関係のインストール

npm install

サーバーのビルド

npm run build

自動再構築での開発

npm run watch

📚 ドキュメント

API 実装

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

1. ListResources - リポジトリ内のファイルとディレクトリを一覧表示します。
2. ReadResource - 特定のファイルの内容を取得します。

認証

サーバーはGitHubの個人用アクセストークンを使用して認証を行います。あなたのトークンがリポジトリの内容にアクセスするための適切な権限を持っていることを確認してください。

エラー処理

サーバーには以下のエラー処理が含まれています。

• 環境変数が不足している場合
• GitHub APIエラー
• 無効なパス（例えば、ディレクトリをファイルとして読み取ろうとする場合）
• 認証に失敗した場合

デバッグ

MCPサーバーはstdioを通じて通信するため、デバッグは難しい場合があります。MCP Inspectorを使用してデバッグします。

npm run inspector

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

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

• GitHubの個人用アクセストークンを安全に保管してください。
• 必要最小限の権限を持つトークンを使用することを検討してください。
• リポジトリのサイズ制限に注意してください。大きなリポジトリへのアクセスに影響を与える可能性があります。

📄 ライセンス

MIT