MCP Github Server Plus

🚀 GitHub MCP Server

The GitHub MCP Server is a Model Context Protocol (MCP) server integrated with the GitHub platform. It enables interaction via API, including functions such as code search, issue management, and pull request review.

🚀 Quick Start

The GitHub MCP Server allows users to interact with the GitHub platform through a series of APIs, facilitating operations like code search, issue and pull request management, and more.

✨ Features

• Code Search: Supports precise code search based on conditions such as language, path, and file extension.
• Issue and Pull Request Management: Create, update, query, and delete issues and pull requests.
• Comments and Reviews: Add, retrieve, update, and delete code comments and review opinions.
• Repository Operations: Obtain repository information, including branches, tags, collaborators, etc.
• Search Syntax Support: Provides powerful GitHub search syntax, supporting language filtering, path limitation, tag filtering, and other functions.

📚 Documentation

API Endpoints

Code Search

• /code/search
• Parameters:
  • q: Required. Search query string.
  • language: Optional. Specify the programming language.
  • repo: Optional. Specify a specific repository in the format owner/name.
  • path: Optional. Specify the file path.
  • extension: Optional. Specify the file extension.

Issue Management

• /issues
• Parameters:
  • q: Optional. Search query string.
  • is: Optional. Filter type, supporting issue or pr.
  • state: Optional. Filter status, supporting open or closed.
  • label: Optional. Specify the label.

Reviews and Comments

• /pulls/reviews
• Parameters:
  • pull_number: Required. Specify the pull request number.
  • comments: Optional. Retrieve review opinions.

Repository Information

• /repos/{owner}/{name}
• Returns detailed information about the specified repository, including branches, tags, etc.

Search Query Syntax

Code Search Example

q: "import express" language:typescript path:src/

Issue Search Example

q: "memory leak" is:issue is:open label:bug author:username

User Search Example

q: "fullstack developer" location:London followers:>1000 type:user

📦 Installation

Personal Access Token

To use the GitHub MCP Server, you need to create a GitHub Personal Access Token with appropriate permissions:

1. Visit Personal access tokens.
2. Click the "Generate new token" button.
3. Select the required permission scope (e.g., repo, admin:repo).
4. Copy and save the generated token.

Docker Configuration

Build the Image

docker build -t github-mcp-server .

Run the Container

docker run --name mcp-server \
  -p 3000:3000 \
  -e GITHUB_TOKEN=your_token_here \
  github-mcp-server

Claude Desktop Configuration

In Claude Desktop, you can configure the GitHub MCP Server as follows:

JSON Configuration Example

{
  "name": "GitHub MCP Server",
  "type": "docker",
  "image": "github-mcp-server:latest",
  "args": ["--port", "3000"],
  "envs": {
    "GITHUB_TOKEN": "your_token_here"
  }
}

📄 License

This project is licensed under the MIT License, allowing free use, modification, and distribution, but the copyright notice and license information must be retained.