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 企业的无缝集成。