Github MCP Bridge

A GitHub Enterprise data query service based on the MCP protocol that allows AI agents to securely obtain enterprise license usage, user permissions, and other data through the API. It supports dual - transport mode and Kubernetes deployment.

Developer tools Version control #GitHub management #Enterprise permissions #AI integration #Data query .Python

rating : 2 points

downloads : 9

update time : 2025-04-28

What is MCP GitHub Enterprise?

This is a server based on the Model Context Protocol (MCP) that allows AI assistants (such as Claude, ChatGPT, etc.) to securely query your GitHub Enterprise license data. It provides information such as license usage, user permissions, and organizational structure through a standardized interface.

How to use MCP GitHub Enterprise?

You can query GitHub Enterprise data through simple natural language commands, such as 'Show our license usage' or 'Query the permissions of user johndoe'. The system supports multiple deployment methods, including local operation and Docker container deployment.

Use cases

It is suitable for scenarios such as enterprise IT management, license monitoring, user permission auditing, and organizational structure analysis. It is especially suitable for administrators who need to regularly check the usage of GitHub Enterprise.

Main features

License analysisProvides a comparative analysis of the total number of licenses and the number of used licenses to help you understand license usage.

User queryQueries information such as the user's affiliated organization, role permissions, 2FA status, and SAML ID.

Automatic paginationAutomatically handles data pagination for large enterprises without manual operation.

Dual transport modeSupports two communication methods: direct stdio interaction and SSE HTTP streaming transmission.

Advantages and limitations

Advantages

Simplifies the process of querying GitHub Enterprise data

Supports natural language interaction, reducing the usage threshold

Can be integrated into existing AI assistants and workflows

Provides detailed user and organizational permission information

Limitations

Requires GitHub Enterprise administrator permissions

Depends on the Python 3.9+ environment

There may be delays in querying large - scale enterprise data

How to use

Environment preparation

Ensure that Python 3.9 or a higher version is installed, and prepare a GitHub personal access token (PAT) with appropriate permissions.

Clone the repository

Clone the project code from GitHub to the local machine.

Install dependencies

Create a virtual environment and install the required dependencies.

Configure environment variables

Copy the example environment file and fill in your GitHub credentials and enterprise URL.

Run the service

Select the transport mode and start the service.

Usage examples

License usage monitoringRegularly check the enterprise license usage to ensure that the limit is not exceeded.

User permission auditingCheck the permissions and organizational affiliations of a specific user in the enterprise.

Security compliance checkVerify whether the user has enabled two - factor authentication (2FA).

Frequently Asked Questions

What permissions are required for the GitHub token?

Which GitHub versions are supported?

How to handle data for large enterprises?

Can it be deployed on Kubernetes?

Related resources

Model Context Protocol SDK

Python SDK documentation for the MCP protocol

GitHub Enterprise API documentation

Official GitHub REST API reference

Example deployment configuration

Examples of Docker and Kubernetes deployment

🚀 MCP GITHUB Enterprise Edition 🌉

A Model Context Protocol (MCP) server that enables AI agents (such as Claude and ChatGPT) to query your GitHub Enterprise Edition license data. Securely obtain license summaries, user details, organizational memberships, and enterprise roles through the /consumed-licenses endpoint.

🚀 Quick Start

Installation

Clone the repository:

git clone https://github.com/yourusername/mcp-github.git
cd mcp-github

Install dependencies:

pip install -r requirements.txt

Configure environment variables:

export GITHUB_TOKEN="Your GitHub Token"

Run the server:

python server.py

Access the API:

curl http://localhost:8000/consumed-licenses

✨ Features

Functionality and Example Prompts

License Summary • "Show the license summary of our GitHub Enterprise." • "How many licenses are currently in use?"
Detailed License Usage • "List all consumed GitHub licenses." • "Are there any unused GitHub licenses?"
User Search • "Which GitHub organizations does johndoe belong to?" • "What enterprise roles does johndoe have?" • "Get the detailed information of johndoe."

Feature Highlights

Property	Details
`list_consumed_licenses`	Summarize licenses, optionally including user information.
`get_user_organizations`	List a user's GitHub organizational memberships.
`get_user_enterprise_roles`	List a user's enterprise roles.
`get_user_detail`	Get a user's complete license details.

⚠️ Important Note

Store your GitHub token securely.
Use an appropriate permission scope for your GitHub token.
Consider using tools like AWS Secrets Manager in a production environment.
Implement network policies in a Kubernetes deployment.

🤝 Contribution Guidelines

Contributions are welcome! Please feel free to submit pull requests.

Fork the repository:

git clone https://github.com/yourusername/mcp-github.git
cd mcp-github

Create a feature branch:

git checkout -b feature/amazing-feature

Commit your changes:

git commit -m 'Add some amazing features'

Push to the repository:

git push origin feature/amazing-feature

Create a pull request.

📄 License

This project is released under the MIT License. Please refer to the LICENSE file for details.

🙏 Acknowledgments

Thanks to the following projects for their contributions:

Model Context Protocol for providing the Python SDK.
MCP-Mem0 for providing an excellent template structure.
GitHub API for providing comprehensive documentation.

A meticulously crafted solution for AI ↔️ GitHub Enterprise Edition integration.

Featured MCP Services

Gitlab MCP Server

Certified

The GitLab MCP server is a project based on the Model Context Protocol that provides a comprehensive toolset for interacting with GitLab accounts, including code review, merge request management, CI/CD configuration, and other functions.

A Python-based MCP Server that provides advanced to-do list management and content organization functions through the Notion API, enabling seamless integration between AI models and Notion.

Markdownify is a multi-functional file conversion service that supports converting multiple formats such as PDFs, images, audio, and web page content into Markdown format.

TypeScript

1.7K

5 points

Duckduckgo MCP Server

Certified

The DuckDuckGo Search MCP Server provides web search and content scraping services for LLMs such as Claude.

Framelink Figma MCP Server is a server that provides access to Figma design data for AI programming tools (such as Cursor). By simplifying the Figma API response, it helps AI more accurately achieve one - click conversion from design to code.

UnityMCP is a Unity editor plugin that implements the Model Context Protocol (MCP), providing seamless integration between Unity and AI assistants, including real - time state monitoring, remote command execution, and log functions.

564

5 points

Gmail MCP Server

A Gmail automatic authentication MCP server designed for Claude Desktop, supporting Gmail management through natural language interaction, including complete functions such as sending emails, label management, and batch operations.

The MiniMax Model Context Protocol (MCP) is an official server that supports interaction with powerful text-to-speech, video/image generation APIs, and is suitable for various client tools such as Claude Desktop and Cursor.

Python

753

4.8 points

Zhiqi Future, Your AI Solution Think Tank

English 简体中文繁體中文にほんご