GitHub MCP Server

Official implementation of the Model Context Protocol (MCP) server by GitHub. The project aims to standardize GitHub platform capabilities (Repo management, Issue/PR automation, CI/CD monitoring, security analysis) into toolsets callable by AI models.

Core Features#

• Repository Management: Browse and query code, search files, analyze commits, understand project structure
• Issue & PR Automation: Create, update, manage issues and pull requests, AI-assisted bug triage, code change review
• CI/CD & Workflow Intelligence: Monitor GitHub Actions workflow runs, analyze build failures, manage releases
• Code Analysis: Inspect security findings, review Dependabot alerts, understand code patterns
• Team Collaboration: Access discussions, manage notifications, analyze team activity

Deployment Modes#

1. Remote GitHub MCP Server: GitHub-hosted remote server (recommended)
2. Local GitHub MCP Server: Local Docker or source build deployment

Toolset System#

Supports 20+ toolsets, including:

• context (recommended): Provides current user and GitHub context
• actions: GitHub Actions workflows and CI/CD operations
• code_security: Code security related tools
• issues, pull_requests, repos: Core GitHub functionality
• copilot, dependabot, discussions and other advanced features

Special Modes#

• Read-Only Mode: Prevents modification operations
• Lockdown Mode: Restricts display of non-collaborator content in public repos
• Insiders Mode: Early access to new features and experimental tools
• Dynamic Tool Discovery: Dynamic toolset discovery (Beta)

Quick Start#

Remote Server (VS Code Configuration)#

{
  "servers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/"
    }
  }
}

Local Docker Deployment#

docker run -i --rm \
  -e GITHUB_PERSONAL_ACCESS_TOKEN=<your-token> \
  ghcr.io/github/github-mcp-server

Build from Source#

go build -o github-mcp-server ./cmd/github-mcp-server
GITHUB_PERSONAL_ACCESS_TOKEN=<your-token> ./github-mcp-server stdio

Configuration Capabilities#

• Toolset Configuration: --toolsets repos,issues,pull_requests,actions,code_security
• Individual Tool Configuration: --tools get_file_contents,issue_read,create_pull_request
• Read-Only Mode: --read-only or GITHUB_READ_ONLY=1
• Insiders Mode: --insiders or GITHUB_INSIDERS=true
• GitHub Enterprise Support: Configure via GITHUB_HOST environment variable

Project Architecture#

• Primary Language: Go (95.8%)
• Auxiliary Languages: TypeScript (2.2%), Shell (1.8%)
• Containerization: Docker support, image at ghcr.io/github/github-mcp-server
• Architecture Pattern: MCP (Model Context Protocol) server implementation