About GitHub MCP Server
GitHub MCP Server is a FastAPI server for accessing selected GitHub repository and issue operations. It supports retrieving repository details, listing issues, and creating issues or comments.
Key features
- 01Retrieve repository details
- 02List repository issues
- 03Create issues
- 04Add issue comments
- 05Handle GitHub API errors
Use cases
- 01Inspect repository details through an MCP client
- 02Review issues for a repository
- 03Create an issue or comment on an existing issue
MCP support
The FastAPI server implements MCP and exposes GitHub repository details and issue operations to MCP clients.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEGitHub MCP Server
A FastAPI server implementing the Model Context Protocol for GitHub interactions.
Setup
- Clone the repository
- Create a virtual environment:
python -m venv venv source venv/bin/activate - Install dependencies:
pip install -r requirements.txt - Create a
.envfile with your GitHub Personal Access Token:GITHUB_TOKEN=your_token_here
Usage
Start the server:
uvicorn server:app --reload --port 8000
API Endpoints
Get Repository Details
GET /repository/{owner}/{repo}
List Issues
GET /repository/{owner}/{repo}/issues
Create Issue
POST /repository/{owner}/{repo}/issues
Create Comment
POST /repository/{owner}/{repo}/issues/{issue_number}/comments
Error Handling
The server implements comprehensive error handling for all GitHub API interactions. Errors are logged and appropriate HTTP status codes are returned.
Type Hints
The codebase uses type hints throughout for better maintainability and IDE support.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.