GitHub MCP 桥

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.

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

模型上下文协议服务器，使 AI 代理能够安全地访问和与 GitHub Enterprise 数据交互，提供对企业用户、组织、电子邮件和许可证信息的访问。

Related MCP Servers

Codebase MCP
DeDeveloper23
A
security
A
license
A
quality
A Model Context Protocol server that enables AI agents to retrieve and understand entire codebases at once, providing tools to analyze local workspaces or remote GitHub repositories.
Last updated -
3
52
MIT License
GitHub MCP Server
PoliTwit1984
A
security
F
license
A
quality
A Model Context Protocol server that enables AI models to interact with GitHub's API, allowing for repository creation and management with descriptions, topics, and website URLs through natural language commands.
Last updated -
GitHub MCP Server
renantrendt
-
security
F
license
-
quality
A Model Context Protocol server that enables AI assistants to perform GitHub operations including repository management, file operations, issue tracking, and pull request creation.
Last updated -
1
GitHub Tools MCP Server
arjunkmrm
-
security
F
license
-
quality
Model Context Protocol server that enables interaction with GitHub repositories, issues, pull requests, and search functionality through natural language.
Last updated -
1

View all related MCP servers

GitHub MCP Bridge