Loglmhq MCP Server Github Repo

🚀 GitHub リポジトリ MCP プロトコルサーバー

このサーバーは、Model Context Protocol (MCP) を実装し、GitHub リポジトリの内容へのアクセス権を提供します。AI アシスタントが指定された GitHub リポジトリ内のファイルを閲覧および読み取ることを可能にします。

🎥 デモ

✨ 主な機能

リソース

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

リソース URI 形式

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

📦 インストール

Claude デスクトップと併用する場合のサーバー設定の追加方法：

設定場所

• 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 チェッカーを使用してデバッグしてください：

npm run inspector

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

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

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

📄 ライセンス

MIT