mcp-server-github
Provides tools for interacting with the GitHub API, enabling management of repositories, issues, pull requests, file contents, code search, branches, and more.
Provides tools for interacting with GitHub Actions workflows and workflow runs.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-server-github list my open pull requests"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
mcp-server-github
An MCP (Model Context Protocol) server that provides tools for interacting with the GitHub API, including repositories, issues, pull requests, code search, branches, and GitHub Actions workflows.
Architecture
graph TB
subgraph Client
style Client fill:#4A90D9,stroke:#2E6BA6,color:#FFFFFF
MCP_Client["MCP Client"]
end
subgraph Server["mcp-server-github"]
style Server fill:#2ECC71,stroke:#1A9B52,color:#FFFFFF
Index["index.ts<br/>MCP Server Entry"]
subgraph Tools
style Tools fill:#F39C12,stroke:#C67D0A,color:#FFFFFF
T1["list_repos"]
T2["create_issue"]
T3["list_pull_requests"]
T4["get_file_contents"]
T5["search_code"]
T6["create_branch"]
T7["list_workflows"]
T8["get_workflow_runs"]
end
end
subgraph External["GitHub API"]
style External fill:#24292E,stroke:#1B1F23,color:#FFFFFF
Repos["Repos API"]
Issues["Issues API"]
PRs["Pull Requests API"]
Contents["Contents API"]
Search["Search API"]
Git["Git Refs API"]
Actions["Actions API"]
end
MCP_Client -- "stdio transport" --> Index
Index --> T1 & T2 & T3 & T4 & T5 & T6 & T7 & T8
T1 --> Repos
T2 --> Issues
T3 --> PRs
T4 --> Contents
T5 --> Search
T6 --> Git
T7 --> Actions
T8 --> ActionsRelated MCP server: GitHub MCP Server
Installation
npm install
npm run buildConfiguration
Variable | Description | Required |
| GitHub personal access token | Yes |
Usage
Standalone
GITHUB_TOKEN=ghp_xxxx npm startDevelopment
npm run devDocker
docker build -t mcp-server-github .
docker run -e GITHUB_TOKEN=ghp_xxxx mcp-server-githubMCP Client Configuration
{
"mcpServers": {
"github": {
"command": "node",
"args": ["dist/index.js"],
"env": {
"GITHUB_TOKEN": "ghp_xxxx"
}
}
}
}Tool Reference
Tool | Description | Parameters |
| List repositories |
|
| Create an issue |
|
| List pull requests |
|
| Get file contents |
|
| Search code |
|
| Create a branch |
|
| List workflows |
|
| Get workflow runs |
|
License
MIT
Available Tools
8 toolscreate_branchB
Create a new branch in a repository from a source branch
Inputs: owner (required), repo (required), branch (required), from_branch.
create_issueB
Create an issue in a GitHub repository with title, body, labels, and assignees
Inputs: owner (required), repo (required), title (required), body, +2 more.
get_file_contentsB
Get file or directory contents from a GitHub repository
Inputs: owner (required), repo (required), path (required), ref.
get_workflow_runsB
Get workflow run history for a specific GitHub Actions workflow
Inputs: owner (required), repo (required), workflow_id (required), status.
list_pull_requestsA
List pull requests in a repository with optional state and sort filters
Inputs: owner (required), repo (required), state, sort.
list_reposC
List repositories for a user, organization, or the authenticated user
Inputs: owner, type, sort.
list_workflowsB
List GitHub Actions workflows in a repository
Inputs: owner (required), repo (required).
search_codeB
Search code across GitHub repositories using GitHub search syntax
Inputs: query (required), per_page.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Each tool targets a distinct GitHub resource or action: branches, issues, file contents, workflow runs, pull requests, repos, workflows, and code search. No overlap in purpose.
All tool names use a consistent verb_noun pattern in snake_case (e.g., create_branch, list_pull_requests), making them predictable and easy to interpret.
With 8 tools, the set is well-scoped for a GitHub MCP server, covering essential read operations and some write operations without being bloated.
Missing critical operations like updating or closing issues, creating or merging pull requests, and managing repositories. The surface has notable gaps for typical GitHub workflows.
Maintenance
Related MCP Connectors
Access the GitHub API, enabling file operations, repository management, search functionality, and…
Manage repositories, users, releases, and automate GitHub workflows
Operate GitHub from your AI assistant: repos, PRs, issues, Actions. Previews and read-only mode.
Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables interaction with GitHub repositories through the GitHub API, allowing file operations, repository management, issue tracking, and code search through natural language commands.3321 npm4MIT
- FlicenseNot gradedqualityDmaintenanceEnables access to GitHub repositories and data through the GitHub API. Supports retrieving repositories, issues, pull requests, and searching code across GitHub with authentication via personal access tokens.-
- AlicenseNot gradedqualityNot gradedmaintenanceEnables comprehensive interaction with GitHub repositories, including code management, issues, pull requests, and full GitHub Actions workflow control with triggering, monitoring, and artifact management capabilities.475 npm-
- AlicenseCqualityDmaintenanceEnables comprehensive interaction with the GitHub API for managing repositories, issues, pull requests, commits, and GitHub Actions workflows through natural language.20475 npmMIT