MCP GITHUB ENTERPRISE 🌉
A Model Context Protocol (MCP) server that lets AI agents (Claude, ChatGPT, etc.) query your GitHub Enterprise license data. Securely fetch license summaries, per-user details, org memberships, and enterprise roles via the /consumed-licenses endpoint.
📊 Capabilities & Example Prompts
-
License Summary
•"Show me our GitHub Enterprise license summary"
•"How many licenses are we currently using?" -
Detailed License Usage
•"List all consumed GitHub licenses"
•"Do we have any unused GitHub licenses?" -
User Lookup
•"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?"
🌟 Features
- License Analytics: Total vs. consumed seats
- User Lookup: Org memberships, roles, 2FA, SAML ID
- Pagination: Handles large enterprises automatically
- Dual Transports: stdio for direct MCP, SSE for HTTP
- Kubernetes-Ready: Deploy on EKS/GKE or any K8s cluster
📋 Prerequisites
- Python 3.9+
- GitHub PAT with
read:enterprise/ license scopes - GitHub Enterprise Cloud tenant
🚀 Quick Start
1. Clone & Install
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. Configure
cp .env.example .env
# Edit .env: set GITHUB_TOKEN and GITHUB_ENTERPRISE_URL
3. Run
stdio transport
export TRANSPORT=stdio
python main.py
SSE transport
export TRANSPORT=sse PORT=8050
python main.py
🐳 Docker & n8n
Add this service to your docker-compose.yml alongside n8n:
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
In n8n's UI, enable the MCP client:
- Settings → Credentials → New Credential
- Choose MCP Client API, set URL to http://github-mcp:8050/sse
🔌 Client Configuration
Claude Desktop / Windsurf / Cursor
Add this configuration to your Claude Desktop settings:
{
"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 Configuration
{
"mcpServers": {
"github": {
"transport": "sse",
"url": "http://localhost:8050/sse"
}
}
}
📊 Example Use Cases
- Enterprise User Management: Automate user onboarding and offboarding
- License Monitoring: Get alerts when licenses are close to expiration
- Organization Analysis: Analyze organization structures and relationships
- User Access Auditing: Track user permissions and access levels
- AI-powered GitHub Insights: Let AI analyze your enterprise GitHub data
🔌 MCP Tools & Resources
Tools
| Name | Description |
|---|---|
list_consumed_licenses | Summarize licenses, optionally include users |
get_user_organizations | List a user's GitHub org memberships |
get_user_enterprise_roles | List a user's enterprise roles |
get_user_detail | Full license detail for a user |
Resources
| URI | Description |
|---|---|
github://consumed-licenses/{dummy} | Full license usage + user details |
github://user/{username}/roles | Org & enterprise roles for a user |
🔒 Security Considerations
- Store your GitHub token securely
- Use appropriate scopes for your GitHub token
- For production, consider using AWS Secrets Manager or similar
- Implement network policies in Kubernetes deployments
🤝 Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
📜 License
This project is licensed under the MIT License - see the LICENSE file for details.
🙏 Acknowledgements
- Model Context Protocol for the Python SDK
- MCP-Mem0 for providing a great template structure
- GitHub API for the comprehensive API
Built with ❤️ for seamless AI ↔️ GitHub Enterprise integration.