Verified project record
github/github-mcp-server
The official GitHub MCP Server connects AI agents, assistants, and chatbots to GitHub's platform APIs for repository management, code analysis, and issue/PR automation. It supports remote GitHub-hosted operation and local execution via Docker or a compiled Go binary.
Project overview
This is the official GitHub MCP Server providing API toolsets that enable AI tools to query code, analyze commits, manage issues, and monitor workflow runs through natural language.
- Project type
- MCP · AI Coding
- Use cases
- Knowledge Q&A · Coding & Development
- Deployment
- Refer to project documentation
- License
- MIT
Best for
- Developers and AI engineers using GitHub for version control who want to interact with repository data via compatible MCP hosts.
Key capabilities
- Enables AI tools to browse and query code, search files, analyze commits, manage issues and pull requests, monitor GitHub Actions workflow runs, and analyze Dependabot alerts.
- Provides a GitHub-hosted remote MCP server intended as a straightforward method for getting up and running without local deployment.
- Allows running the server locally using Docker or a compiled Go binary, supporting stdio transport for integration with an MCP host.
- Supports enabling or disabling specific groups of functionalities via the --toolsets flag to control which GitHub API capabilities are available to AI tools.
- Runs the server offering only read-only tools to prevent modifications to repositories, issues, or pull requests.
- Limits content surfaced from public repositories by checking if the item's author has push access to the repository.
- Provides CLI subcommands such as tool-search for debugging and exploring available server tools.
Limitations and risks
- The exported Go API of this module should currently be considered unstable and is subject to breaking changes.
Getting started
- Install Docker or a compatible MCP host. For local deployments, prepare a GitHub Personal Access Token; for the hosted remote server, authenticate using OAuth upon first use. Run the server via a docker run command or a one-click install process.
Alternatives and comparisons
- Installs a skill or MCP server that guides an agent to fetch documentation using ctx7 CLI commands or documentation tools.
- Provides query, path, and explain commands to ask questions or trace connections against a generated graph.json using tree-sitter AST parsing.
- Parses codebases using Tree-sitter to extract dependencies and execution flows so AI tools receive architectural context in one query.
Project comparisons
- github/github-mcp-server vs Fetches up-to-date, version-specific documentation directly into the LLM's prompt.
- github/github-mcp-server vs Turns folders of code or media into a queryable knowledge graph.
- github/github-mcp-server vs Indexes codebases into a precomputed knowledge graph exposed via MCP tools.
Evidence and sources
- GitHub project description: GitHub's official MCP Server
- README: The GitHub MCP Server connects AI tools directly to GitHub's platform. This gives AI agents, assistants, and chatbots the ability to read repositories and code files, manage issue…
- README: - Repository Management: Browse and query code, search files, analyze commits, and understand project structure across any repository you have access to. - Issue & PR Automation:…
- README: The remote GitHub MCP Server is hosted by GitHub and provides the easiest method for getting up and running.
- README: 1. A compatible MCP host with remote server support (VS Code 1.101+, Claude Desktop, Cursor, Windsurf, etc.)
AI Search
Find projects, verify facts, compare options, or turn a complex need into an actionable plan
Try a searchA click only fills the search box; you stay in control
Project Details
0