GitHub MCP Server

A production-grade MCP server that lets any LLM interact with GitHub repositories via natural language using the MCP protocol over Streamable HTTP.

Tools

• list_repos - list all repos for a GitHub user

• get_repo - get details of a specific repo

• list_issues - list open issues on a repo

• create_issue - create a new issue

• list_prs - list open pull requests

• get_file - read a file from a repo

Related MCP server: GitHub MCP Server

Stack

• FastMCP v3 (Streamable HTTP transport)

• GitHub REST API

• Docker

Features

• Rate limiting with exponential backoff (retries on 429)

• Structured logging for every tool call

• Error handling via raise_for_status

Setup

1. Create a .env file:

GITHUB_TOKEN=your_github_personal_access_token

2. Run with Docker:

docker-compose up --build -d

Connect via MCP Inspector

http://localhost:8000/mcp

Connect via Codex CLI

Add to ~/.codex/config.toml:

[mcp_servers.github-mcp]
type = "streamable_http"
url = "http://127.0.0.1:8000/mcp"

Port

• 8000 (local)

• 8009 (Docker)

GitHub

github.com/MSaiRam10/GitHubMCP