================== /// 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
# Transform Your GitHub Workflow with Augment Code The **GitHub MCP Server** is GitHub's official Model Context Protocol server that transforms Augment Code into a powerful GitHub automation hub. Instead of constantly switching between your IDE and GitHub's web interface, you can now manage repositories, issues, pull requests, workflows, and more directly through natural language conversations with Augment. ## Seamless GitHub Integration in Your Coding Flow With this MCP server connected to Augment Code, you can perform complex GitHub operations without breaking your coding flow. Ask Augment to "create a PR for this feature branch with a detailed description" or "check the status of CI workflows and rerun any failed jobs" - and watch it execute these multi-step operations seamlessly. The server provides access to GitHub's complete API surface, from basic repository operations to advanced workflow management, code scanning alerts, and Dependabot integration. ## Supercharge Your Development Productivity This integration delivers immediate productivity gains by eliminating context switching and enabling GitHub automation directly from your coding environment. Augment can now analyze your current codebase, create issues with proper labels and assignees, generate comprehensive pull request descriptions, manage code reviews, and even integrate with GitHub's security scanning tools - all while you stay focused on writing code. The server's configurable toolsets mean you can tailor the available GitHub operations to match your team's workflow, enabling read-only access for junior developers or full automation capabilities for senior team members. **Perfect for teams** building on GitHub who want to streamline their development workflow, automate repetitive GitHub tasks, and maintain better project visibility without leaving their IDE. Configure it once in Augment's MCP settings, and unlock a GitHub-native development experience that scales with your team's needs.
License: MIT License
Updated 7/15/2025