Github Plus

🚀 GitHub Model Context Protocol (MCP) Server

The GitHub MCP Server is a powerful tool that offers a range of features to enhance your GitHub experience. It simplifies code search, issue tracking, pull request management, and more, all in one place.

🚀 Quick Start

Initializing a Repository

When initializing a new repository, you need to configure the following parameters:

• owner: The repository owner
• name: The repository name
• description: A description of the repository (optional)
• private: Whether the repository is private (default is public)

Example command:

git init --owner="yourusername" --name="myrepo" --description="My new project"

Code Search

The server supports the following advanced search features:

Search Parameters

• language:javascript: Filter by programming language
• repo:owner/name: Specify a repository to search
• path:app/src: Filter by path
• extension:js: Filter by file extension
• Example: q: "import express" language:typescript path:src/

Issue Management

Label Operations

• Add a label: gh issue add-label --label bug
• Remove a label: gh issue remove-label --label bug
• List all labels: gh issue list-labels

Status Query

gh issue status --owner=myorg --repo=projectx

Pull Request Management

Creating a Pull Request

gh pr create --head mybranch --base main --title "Add new feature" --body "Implement a new user login function"

✨ Features

The GitHub MCP Server provides the following features:

1. Code Search: Quickly find the code you need across multiple repositories.
2. Issue Tracking: Keep track of issues and manage them efficiently.
3. Pull Request Management: Review and merge pull requests with ease.
4. User and Organization Information: Access detailed information about users and organizations.
5. Repository Operations: Perform various operations on repositories, such as creation, deletion, and modification.

📦 Installation

Personal Access Token

Follow these steps to create a GitHub personal access token:

1. Visit the Personal Access Tokens page.
2. Click "Generate new token".
3. Configure the scope of permissions.
4. Copy the generated token.

Using Claude Desktop

Add the following configuration to claude_desktop_config.json:

Docker Mode

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

NPX Mode

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

Building the Docker Image

Use the following command to build the Docker image:

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

📄 License

This GitHub MCP Server is licensed under the Open Source License. Users are permitted to use, modify, and distribute the software freely, subject to the terms of the license.