GitHub MCP Server - Local Docker Setup

What is GitHub MCP Server - Local Docker Setup?

This project provides an easy way to run the official GitHub MCP Server locally using Docker Compose with HTTP access on port 3000. The GitHub MCP Server is a Model Context Protocol (MCP) server that integrates with GitHub APIs, enabling automation and interaction capabilities for developers and tools.

How to use GitHub MCP Server - Local Docker Setup?

Clone the repository, copy .env.example to .env, set your GitHub Personal Access Token, then run docker-compose up -d. The server listens on http://localhost:3000 and accepts MCP protocol requests via HTTP POST (e.g., curl -X POST http://localhost:3000/mcp with a JSON-RPC body).

Key features of GitHub MCP Server - Local Docker Setup

• Start the server with a single docker-compose up command.
• Access the MCP server via HTTP on port 3000.
• Supports all GitHub MCP Server configuration options.
• Containers automatically restart on failure.
• Enable specific toolsets via GITHUB_TOOLSETS environment variable.

Use cases of GitHub MCP Server - Local Docker Setup

• Automate repository file operations, branch management, and commits.
• Create, read, update, and comment on issues programmatically.
• Perform pull request operations such as create, merge, and review.
• Query code scanning alerts and other security features.
• Enable experimental features for testing new capabilities.

FAQ from GitHub MCP Server - Local Docker Setup

What is the difference between this setup and the official GitHub MCP Server?

This repository wraps the official GitHub MCP Server in a Docker container with an HTTP proxy, making it easy to run locally without manual CLI configuration. It adds HTTP access on port 3000 and Docker management.

What are the prerequisites to run this server?

Docker and Docker Compose must be installed. You also need a GitHub Personal Access Token with appropriate permissions.

How do I enable only certain toolsets?

Set the GITHUB_TOOLSETS environment variable in your .env file to a comma-separated list (e.g., repos,issues,pull_requests). Available toolsets include repos, issues, users, pull_requests, code_security, and experiments.

How can I check if the server is running?

Use curl http://localhost:3000/health for a health check, or docker-compose ps to list running containers.

How do I view logs or restart the server?

View logs with docker-compose logs -f. To rebuild and restart, use docker-compose down, then docker-compose build --no-cache, and finally docker-compose up -d.