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

Related MCP server: GitHub MCP Server

🌟 特徴

• ライセンス分析: 合計シート数と消費シート数

• ユーザー検索: 組織メンバーシップ、役割、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 ツールとリソース

ツール

リソース

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

• GitHubトークンを安全に保管する

• GitHubトークンに適切なスコープを使用する

• 本番環境ではAWS Secrets Managerなどの使用を検討してください

• Kubernetes デプロイメントでネットワーク ポリシーを実装する

🤝 貢献する

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

1. リポジトリをフォークする

2. 機能ブランチを作成します（ git checkout -b feature/amazing-feature ）

3. 変更をコミットします ( git commit -m 'Add some amazing feature' )

4. ブランチにプッシュする ( git push origin feature/amazing-feature )

5. プルリクエストを開く

📜 ライセンス

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

🙏 謝辞

• Python SDK のモデルコンテキストプロトコル

• 優れたテンプレート構造を提供するMCP-Mem0

• 包括的なAPIのためのGitHub API

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