GitHub MCP ブリッジ

MCP GitHub エンタープライズ 🌉

AIエージェント（Claude、ChatGPTなど）がGitHub Enterpriseライセンスデータを照会できるようにするModel Context Protocol（MCP）サーバー/consumed-licensesエンドポイントを介して、ライセンスの概要、ユーザーごとの詳細情報、組織メンバーシップ、エンタープライズロールを安全に取得できます。

📊 機能とプロンプト例

ライセンスの概要
• "Show me our GitHub Enterprise license summary"
• "How many licenses are we currently using?"
ライセンスの詳細な使用状況
• "List all consumed GitHub licenses"
• "Do we have any unused GitHub licenses?"
ユーザー検索
• "What GitHub orgs does johndoe belong to?"
• "What enterprise roles does johndoe have?"
• "Is johndoe an owner in our enterprise?"
• "Get detailed info about johndoe"
• "Does johndoe have 2FA enabled?"

🌟 特徴

ライセンス分析: 合計シート数と消費シート数
ユーザー検索: 組織メンバーシップ、役割、2FA、SAML ID
ページネーション: 大規模な企業を自動的に処理します
デュアルトランスポート: 直接 MCP の場合は stdio、HTTP の場合は SSE
Kubernetes対応：EKS/GKEまたは任意のK8sクラスターにデプロイ可能

📋 前提条件

Python 3.9以上
read:enterprise / license スコープを持つ GitHub PAT
GitHub Enterprise Cloud テナント

🚀 クイックスタート

1. クローンとインストール

git clone https://github.com/vipink1203/mcp-github-enterprise.git
cd mcp-github-enterprise
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

2. 設定する

cp .env.example .env
# Edit .env: set GITHUB_TOKEN and GITHUB_ENTERPRISE_URL

3. 走る

stdioトランスポート

export TRANSPORT=stdio
python main.py

SSE輸送

export TRANSPORT=sse PORT=8050
python main.py

🐳 Docker と n8n

このサービスを n8n と一緒に docker-compose.yml に追加します。

services:
  github-mcp:
    image: ghcr.io/vipink1203/mcp-github-enterprise:latest
    environment:
      - GITHUB_TOKEN=${GITHUB_TOKEN}
      - GITHUB_ENTERPRISE_URL=${GITHUB_ENTERPRISE_URL}
      - TRANSPORT=sse
      - PORT=8050
    ports:
      - "8050:8050"
    restart: unless-stopped
    networks:
      - n8n-network

n8n の UI で、MCP クライアントを有効にします。

設定 → 資格情報 → 新しい資格情報
MCPクライアントAPIを選択し、URLをhttp://github-mcp:8050/sseに設定します。

🔌 クライアント構成

クロードデスクトップ / ウィンドサーフィン / カーソル

この構成を Claude Desktop 設定に追加します。

{
  "mcpServers": {
   "github-ent": {
     "command": "/path/to/your/venv/python",
     "args": ["/path/to/main.py"],
     "env": {
       "GITHUB_TOKEN": "",
       "GITHUB_ENTERPRISE_URL": "https://api.github.com/enterprises/{enterprise_name}",
       "TRANSPORT": "stdio"
     }
   }
}

SSE構成

{
  "mcpServers": {
    "github": {
      "transport": "sse",
      "url": "http://localhost:8050/sse"
    }
  }
}

📊 使用例

エンタープライズユーザー管理: ユーザーのオンボーディングとオフボーディングを自動化
ライセンス監視: ライセンスの有効期限が近づくとアラートを受け取る
組織分析：組織の構造と関係を分析する
ユーザーアクセス監査: ユーザーの権限とアクセスレベルを追跡する
AIを活用したGitHub Insights ：企業のGitHubデータをAIで分析

🔌 MCP ツールとリソース

ツール

名前	説明
`list_consumed_licenses`	ライセンスの概要（オプションでユーザーを含む）
`get_user_organizations`	ユーザーの GitHub 組織メンバーシップを一覧表示する
`get_user_enterprise_roles`	ユーザーのエンタープライズロールを一覧表示する
`get_user_detail`	ユーザーの完全なライセンスの詳細

リソース

URI	説明
`github://consumed-licenses/{dummy}`	完全なライセンス使用状況 + ユーザーの詳細
`github://user/{username}/roles`	ユーザーの組織およびエンタープライズの役割

🔒 セキュリティに関する考慮事項

GitHubトークンを安全に保管する
GitHubトークンに適切なスコープを使用する
本番環境ではAWS Secrets Managerなどの使用を検討してください
Kubernetes デプロイメントでネットワークポリシーを実装する

🤝 貢献する

貢献を歓迎します！お気軽にプルリクエストを送信してください。

リポジトリをフォークする
機能ブランチを作成します（ git checkout -b feature/amazing-feature ）
変更をコミットします ( git commit -m 'Add some amazing feature' )
ブランチにプッシュする ( git push origin feature/amazing-feature )
プルリクエストを開く

📜 ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。

🙏 謝辞

Python SDK のモデルコンテキストプロトコル
優れたテンプレート構造を提供するMCP-Mem0
包括的なAPIのためのGitHub API

シームレスな AI ↔️ GitHub Enterprise 統合のために ❤️ で構築されています。

GitHub MCP Bridge

Integrations