FixingPixels/mcp-server
If you are the rightful owner of mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
A Model Context Protocol (MCP) server for GitHub repositories, built using the Python SDK.
GitHub MCP Server
A Model Context Protocol (MCP) server for GitHub repositories, built using the Python SDK.
Overview
This server implements the Model Context Protocol (MCP) for GitHub repositories, allowing AI assistants to access repository context such as files, commits, issues, and pull requests. It's built using the MCP Python SDK and designed to be deployed on Heroku.
Features
- Access GitHub repository files and content
- Retrieve commit history
- Access issues and pull requests
- Secure authentication and access control
- Rate limiting and caching for GitHub API
- Compatible with MCP-enabled AI assistants
Requirements
- Python 3.8+
- GitHub API access
- Heroku account (for deployment)
Installation
-
Clone the repository:
git clone https://github.com/FixingPixels/mcp-server.git cd mcp-server -
Create a virtual environment:
python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate -
Install dependencies:
pip install -r requirements.txt -
Set up environment variables:
cp .env.example .env # Edit .env with your GitHub API token and other settings
Usage
Local Development
uvicorn src.mcp_server.main:app --reload
Deployment
This server is designed to be deployed on Heroku. See the for details.
Documentation
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
License
This project is licensed under the MIT License - see the LICENSE file for details.
