MCP Github Enterprise

🚀 MCP 企業版 GITHUB 服務器 🌉

一個模型上下文協議（MCP）服務器，允許 AI 代理（Claude、ChatGPT 等）查詢您的 GitHub 企業許可數據。通過 /consumed-licenses 端點，您可以安全地獲取許可證摘要、用戶詳細信息、組織成員身份和企業角色。

🚀 快速開始

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
# 編輯 .env: 設置 GITHUB_TOKEN 和 GITHUB_ENTERPRISE_URL

3. 運行

標準輸入輸出（stdio）傳輸

python -m mcp_github

服務器端事件流（SSE）傳輸

python -m mcp_github sse

✨ 主要特性

• 許可證分析：可查看總許可數與已使用許可數。
• 用戶查找：支持查詢組織成員身份、角色、雙因素認證（2FA）、SAML ID。
• 分頁：自動處理大型企業數據。
• 雙重傳輸：支持標準輸入輸出（stdio）和服務器端事件流（SSE）。
• Kubernetes 就緒：可部署在 EKS/GKE 或任何 K8s 集群。

📦 安裝指南

先決條件

• Python 3.9+
• 具備 read:enterprise 和許可作用域的 GitHub 私有令牌（PAT）
• GitHub 企業版雲租戶

💻 使用示例

功能與示例提示

許可證摘要

• "顯示我們 GitHub 企業的許可摘要"
• "我們目前使用了多少個許可證？"

詳細的許可證使用情況

• "列出所有已使用的 GitHub 許可證"
• "是否有未使用的 GitHub 許可證？"

用戶查找

• "johndoe 屬於哪些 GitHub 組織？"
• "johndoe 在企業中有何角色？"
• "johndoe 是否是企業的所有者？"
• "獲取 johndoe 的詳細信息"
• "johndoe 是否啟用了雙重身份驗證？"

📚 詳細文檔

工具

🤝 貢獻

歡迎貢獻！請隨意提交拉取請求。

1. 叉克隆倉庫。
2. 創建功能分支（git checkout -b feature/amazing-feature）。
3. 提交更改（git commit -m '添加一些很棒的功能'）。
4. 推送到分支（git push origin feature/amazing-feature）。
5. 打開拉取請求。

📄 許可證

該項目在 MIT 許可證下發布，詳情請參閱 LICENSE 文件。

Built with ❤️ 為了實現 AI ↔️ GitHub 企業的無縫集成。