🚀 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 是否启用了双重身份验证？"
📚 详细文档
工具
| 名称 | 描述 |
|---|---|
list_consumed_licenses |
汇总许可证信息，可选包含用户详细信息 |
get_user_organizations |
列出用户的 GitHub 组织成员身份 |
get_user_enterprise_roles |
列出用户的企业角色 |
get_user_detail |
获取用户的完整许可详细信息 |
🤝 贡献
欢迎贡献！请随意提交拉取请求。
- 叉克隆仓库。
- 创建功能分支（
git checkout -b feature/amazing-feature）。 - 提交更改（
git commit -m '添加一些很棒的功能'）。 - 推送到分支（
git push origin feature/amazing-feature）。 - 打开拉取请求。
📄 许可证
该项目在 MIT 许可证下发布，详情请参阅 LICENSE 文件。
Built with ❤️ 为了实现 AI ↔️ GitHub 企业的无缝集成。