# 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

## 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`:

```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