remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Provides access to GitHub repository contents, allowing browsing and reading files from specified repositories, navigating directories, and supporting branch-specific file access.

MCP GitHub リポジトリサーバー

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

デモ

特徴

リソース

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 エンドポイントを実装します。

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

認証

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

エラー処理

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

環境変数が見つかりません
GitHub APIエラー
無効なパス（例：ディレクトリをファイルとして読み取ろうとする）
認証失敗

デバッグ

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

npm run inspector

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

セキュリティノート

GitHub 個人アクセストークンを安全に保つ
必要最小限の権限を持つトークンの使用を検討する
大規模なリポジトリにアクセスする場合は、リポジトリのサイズ制限に注意してください。

ライセンス

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

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

AI アシスタントが指定された GitHub リポジトリからファイルを参照して読み取ることができるサーバー。モデルコンテキストプロトコルを介してリポジトリの内容にアクセスできるようにします。

Related Resources

Reddit Discussion about this server

MCP GitHub Repository Server