Github MCP Server M4n

The GitHub MCP Server is a middleware service based on the GitHub API, providing comprehensive GitHub operation interfaces for file operations, repository management, search functions, etc.

Developer tools Version control #GitHub Interface #Code Management #Repository Operations #Search Service Remote .TypeScript

rating : 2 points

downloads : 7.5K

update time : 2025-04-23

Open Site

What is GitHub MCP Server?

GitHub MCP Server is a specialized interface that connects your applications with GitHub's API. It simplifies GitHub operations like managing repositories, files, issues, and pull requests through a standardized protocol.

How to use GitHub MCP Server?

After setting up with a GitHub personal access token, you can interact with GitHub repositories through simple API calls. The server handles complex operations like branch management automatically.

Use Cases

Ideal for automating GitHub workflows, building CI/CD pipelines, creating GitHub bots, or developing applications that need GitHub integration without complex API handling.

Key Features

File Operations

Create, update, and manage files in repositories with automatic branch handling.

Repository Management

Create, fork, and search repositories with simple commands.

Issue & PR Management

Full lifecycle management of issues and pull requests including comments and reviews.

Advanced Search

Powerful search capabilities for code, issues, and users across GitHub.

Batch Operations

Perform multiple file operations in a single commit for efficiency.

Advantages

Simplifies complex GitHub API operations into easy-to-use commands

Automatic branch management reduces manual work

Maintains proper Git history without force pushing

Comprehensive error handling makes troubleshooting easier

Supports both single and batch operations

Limitations

Requires GitHub personal access token setup

Limited to GitHub platform functionality

Advanced features may require understanding of Git concepts

Rate limits apply based on GitHub API restrictions

Getting Started

Obtain GitHub Token

Create a personal access token with appropriate permissions from GitHub settings.

Configure Server

Add the server configuration to your application settings with your token.

Start Using

Begin making requests to the server endpoints for your GitHub operations.

Example Use Cases

Automated Documentation Updates

Update project documentation automatically when source files change

Issue Triage System

Automatically categorize and label new issues based on content

Code Search Dashboard

Build a dashboard showing code patterns across multiple repositories

Frequently Asked Questions

What permissions does the GitHub token need?

How does automatic branch creation work?

Can I use this with GitHub Enterprise?

How are merge conflicts handled?

Additional Resources

GitHub API Documentation

Official GitHub REST API reference

MCP Protocol Specification

Model Context Protocol documentation

GitHub Search Syntax Guide

Learn advanced search techniques

🚀 GitHub MCP Server

The GitHub MCP (Model Context Protocol) server offers a suite of features for efficient code management and issue tracking on GitHub.

🚀 Quick Start

The GitHub MCP Server provides a range of powerful features for interacting with GitHub repositories. It simplifies tasks such as code search, issue tracking, and review management.

✨ Features

MCP Features

The GitHub MCP (Model Context Protocol) server offers the following capabilities:

Code Search: Search for code snippets in specified repositories or paths using specific syntax.
Issue Tracking: Retrieve and manage issues and pull requests on GitHub.
Review Comments: View and operate on review comments related to Pull Requests.
Status Checks: Obtain comprehensive status check results for Pull Requests.
Branch Updates: Automatically update Pull Request branches to the latest version.

Search Syntax

Code Search

language:javascript: Filter by programming language.
repo:owner/name: Search within a specific repository.
path:app/src: Filter by path.
extension:js: Filter by file extension.
Example: q: "import express" language:typescript path:src/

Issue Search

is:issue or is:pr: Filter by type (issue or pull request).
is:open or is:closed: Filter by status.
label:bug: Filter by label.
author:username: Filter by author.
Example: q: "memory leak" is:issue is:open label:bug

User Search

type:user or type:org: Filter by account type.
followers:>1000: Filter by the number of followers.
location:London: Filter by geographical location.
Example: q: "fullstack developer" location:London followers:>100

For more details on search syntax, refer to GitHub Search Documentation.

📦 Installation

Personal Access Token

Create a GitHub personal access token:

Visit Personal access tokens (in GitHub Settings > Developer settings).
Select the scope of repositories you need to access (public, all, or specified).
Create a token with repo permission ("Full control of private repositories").
Copy the generated token.

Using on Claude Desktop

Add the following content to 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>"
      }
    }
  }
}

💻 Usage Examples

Building the Image

Use Docker to build the image:

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

📄 License

This MCP server is distributed under the MIT License. This means you are free to use, modify, and share the software, but you must include the license file when redistributing. For more details, refer to MIT License.