What problem it solves

AI agents, assistants, and chatbots need access to repository context and GitHub capabilities to complete development and collaboration workflows. Without a direct connection, these tools cannot conveniently read repositories and code files, manage issues and pull requests, analyze code, or automate workflows through natural language.

Key features

• Repository and code access — Browse and query code, search files, analyze commits, and understand project structure across repositories available to the authenticated user.

  Source: README, pkg

• Issue and pull request automation — Create, update, and manage issues and pull requests, with support for triage, code review, and project board maintenance.

  Source: README

• Workflow and pipeline intelligence — Monitor GitHub Actions workflow runs, analyze build failures, and manage releases through tools connected to the development pipeline.

  Source: README

• Configurable tool access — Enable complete toolsets or individual tools, combine both forms of configuration, and use read-only mode to prevent write operations.

  Source: README

• Remote and local deployment — Use the GitHub-hosted remote server or run the server locally with Docker or a binary built from source, with OAuth and PAT authentication options.

  Source: README

Quick start

Copied verbatim from the project's README.

{
  "mcp": {
    "servers": {
      "github": {
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "-p",
          "127.0.0.1:8085:8085",
          "-e",
          "GITHUB_OAUTH_CALLBACK_PORT",
          "ghcr.io/github/github-mcp-server"
        ],
        "env": {
          "GITHUB_OAUTH_CALLBACK_PORT": "8085"
        }
      }
    }
  }
}

docker run -i --rm \
  -e GITHUB_PERSONAL_ACCESS_TOKEN=<your-token> \
  -e GITHUB_TOOLSETS="repos,issues,pull_requests,actions,code_security" \
  ghcr.io/github/github-mcp-server

Who it may suit

This project may suit developers and teams that want AI assistants or agents to work with repository data, issues, pull requests, workflows, security findings, and collaboration features. It may also suit MCP host users who need remote or local GitHub integration.

Topics to discuss

• Which toolsets and individual tools should be included in a minimal read-only setup?

• Which MCP host integration workflows need the clearest configuration guidance?

• How should OAuth and GitHub Personal Access Token setups be documented for different environments and enterprise deployments?

Written by ReadmeX AI from the project's README, source and public GitHub data; it may contain mistakes.

Read the original README https://github.com/github/github-mcp-server#readme

ReadmeX opened this community for a trending project; it is not run by the project. Maintainers can claim it from the community page.