GitHub MCP Server

The GitHub MCP Server is a powerful tool for interacting with the GitHub API, enabling file operations, repository management, search functionality, and more. This server is designed to integrate seamlessly with tools like Claude Desktop, providing a robust interface for GitHub operations.

Features

• Automatic Branch Creation: Automatically creates branches when files are created or updated.
• Comprehensive Error Handling: Provides clear error messages for common issues.
• Git History Preservation: Ensures operations maintain proper Git history without force pushing.
• Batch Operations: Supports both single-file and multi-file operations.
• Advanced Search: Enables searching for code, issues, pull requests, and users.

Tools

create_or_update_file

Create or update a single file in a repository.

push_files

Push multiple files in a single commit.

search_repositories

Search for GitHub repositories.

create_repository

Create a new GitHub repository.

get_file_contents

Get contents of a file or directory.

create_issue

Create a new issue.

create_pull_request

Create a new pull request.

fork_repository

Fork a repository.

create_branch

Create a new branch.

list_issues

List and filter repository issues.

update_issue

Update an existing issue.

add_issue_comment

Add a comment to an issue.

search_code

Search for code across GitHub repositories.

search_issues

Search for issues and pull requests.

search_users

Search for GitHub users.

list_commits

Get commits of a branch in a repository.

get_issue

Get the contents of an issue within a repository.

get_pull_request

Get details of a specific pull request.

list_pull_requests

List and filter repository pull requests.

create_pull_request_review

Create a review on a pull request.

merge_pull_request

Merge a pull request.

get_pull_request_files

Get the list of files changed in a pull request.

get_pull_request_status

Get the combined status of all status checks for a pull request.

update_pull_request_branch

Update a pull request branch with the latest changes from the base branch.

get_pull_request_comments

Get the review comments on a pull request.

get_pull_request_reviews

Get the reviews on a pull request.

Search Query Syntax

Code Search

• language:javascript: Search by programming language.
• repo:owner/name: Search in specific repository.
• path:app/src: Search in specific path.
• extension:js: Search by file extension.

Issues Search

• is:issue or is:pr: Filter by type.
• is:open or is:closed: Filter by state.
• label:bug: Search by label.
• author:username: Search by author.

Users Search

• type:user or type:org: Filter by account type.
• followers:>1000: Filter by followers.
• location:London: Search by location.

Setup

Personal Access Token

1. Go to Personal access tokens.
2. Select the repositories you'd like this token to have access to.
3. Create a token with the repo scope.

Usage with Claude Desktop

Add the following to your claude_desktop_config.json:

Docker

{
  "mcpServers": {
    "github": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "GITHUB_PERSONAL_ACCESS_TOKEN", "mcp/github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

NPX

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

Build

Docker build:

docker build -t mcp/github -f src/github/Dockerfile .

License

This MCP server is licensed under the MIT License. For more details, please see the LICENSE file in the project repository.