GitHub Integrated MCP Server

GitHub API連携機能を持つModel Context Protocol (MCP) サーバーです。DockerとGitHub Actionsによる自動化されたCI/CDパイプラインを提供します。

🚀 機能

ファイルシステム操作

• ディレクトリ一覧表示

• ファイル読み込み

• ファイル情報取得

• エコー機能

GitHub API連携

• リポジトリ一覧・詳細取得

• Issue管理（一覧・作成）

• Pull Request管理

• ファイル内容取得・更新

• コード検索

インフラ機能

• Docker コンテナ化

• GitHub Actions CI/CD

• Nginx リバースプロキシ

• Redis キャッシュ対応

• ヘルスチェック

Related MCP server: GitHub MCP Server

📋 前提条件

• Node.js 20+

• Docker & Docker Compose

• GitHub Personal Access Token

🛠️ セットアップ

1. 依存関係のインストール

2. 環境変数の設定

.envファイルを編集し、GitHub Personal Access Tokenを設定：

3. TypeScriptのビルド

🐳 Docker での実行

ローカル開発

🔧 Claude Desktop 設定

%APPDATA%\Claude\claude_desktop_config.json に以下を追加：

📚 利用可能なツール

ファイルシステム

• echo - テキストをエコーバック

• list_directory - ディレクトリの内容を一覧表示

• read_file - ファイルの内容を読み取り

• get_file_info - ファイル/ディレクトリの情報を取得

GitHub API

• github_list_repos - リポジトリ一覧を取得

• github_get_repo - 特定のリポジトリ情報を取得

• github_list_issues - Issue一覧を取得

• github_create_issue - 新しいIssueを作成

• github_list_pull_requests - Pull Request一覧を取得

• github_get_file_content - ファイル内容を取得

• github_create_or_update_file - ファイルを作成/更新

• github_search_code - コードを検索

🚀 開発

ローカル開発サーバー

コードビルド

🔒 セキュリティ

• GitHub Personal Access Token は適切なスコープで制限

• Dockerfile は非rootユーザーで実行

• 環境変数での機密情報管理

🔑 GitHub Personal Access Token の取得

1. GitHub にログイン

2. Settings → Developer settings → Personal access tokens → Tokens (classic)

3. "Generate new token" をクリック

4. 以下のスコープを選択：

   • repo (フルアクセス)

   • read:user

   • user:email

5. トークンをコピーして .env ファイルに設定

🐛 トラブルシューティング

Docker ビルドエラー

GitHub API エラー

• Personal Access Token の有効期限を確認

• 必要なスコープ権限があることを確認

• API レート制限に引っかかっていないか確認

📝 ライセンス

ISC License