================== /// MCP /// /// GIT /// ================== [server:online] [protocol:ready]
github-mcp-server
by github
GitHub’s official Model Context Protocol (MCP) server that exposes rich, tool-oriented access to GitHub’s REST & GraphQL APIs. Supports remote (hosted) or local (Docker / native Go binary) deployment and fine-grained toolset configuration.
17.4k
1.3k
EnterpriseInstallation
1. Prerequisites
• Go 1.22 or later in $PATH
• (Optional) Docker if you prefer container deployment
2. Clone the code
git clone https://github.com/github/github-mcp-server.git
cd github-mcp-server
3. Build a native binary (Linux/macOS/Windows)
go build -o mcp-server ./cmd/server
4. Create a configuration file (config.yaml)
server:
host: 0.0.0.0
port: 8080
auth:
# Secret used to sign/verify Bearer tokens for requests to the MCP Server
token: "<your-mcp-token>"
models:
- id: gpt-4o
provider: openai
api_key: ${OPENAI_API_KEY}
5. Run the server
./mcp-server --config config.yaml
# or simply ./mcp-server (uses default ./config.yaml if present)
6. Container deployment (alternative)
docker build -t github-mcp-server . # or pull ghcr.io/github/github-mcp-server:latest if published
docker run -d \
-p 8080:8080 \
-e MCP_TOKEN="<your-mcp-token>" \
-e OPENAI_API_KEY="$OPENAI_API_KEY" \
github-mcp-server
7. Health check
curl http://localhost:8080/healthz # should return 200 OK
Documentation
License: MIT License
Updated 7/15/2025