Phialsbasement MCP Github Server Plus

🚀 GitHub MCP Server Guide

This guide provides a comprehensive overview of the GitHub MCP server, including installation, supported commands, detailed documentation, and licensing information.

🚀 Quick Start

Install Docker and Start the Service

Download the Image

docker pull mcp/github

Start the Service

docker run -i --rm -e GITHUB_PERSONAL_ACCESS_TOKEN=mYnGfGhp0c3oQ9cd8w5DZvxnWiawQjxOls -p 1234:1234 mcp/github

✨ Features

Supported Commands

• Repository Information: Retrieve information about a repository's commits, branches, and tags.
• Code Search: Support language filtering, path restrictions, and file extension filtering.
• Issue Management: Search for open or closed issues and categorize them by label.
• Pull Requests: View merge status and check results.
• Comments and Reviews: Get code comments and review opinions.

📦 Installation

Install Docker and Start the Service

Download the Image

docker pull mcp/github

Start the Service

docker run -i --rm -e GITHUB_PERSONAL_ACCESS_TOKEN=mYnGfGhp0c3oQ9cd8w5DZvxnWiawQjxOls -p 1234:1234 mcp/github

💻 Usage Examples

Search for Code

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

Search for Issues

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

Search for Users

q: "fullstack developer" location:London followers:>100

Supported Git Commands

Get Repository Information

git ls-remote https://github.com/username/repo.git

Create a New Branch

git branch new-feature -f origin/main:main

Commit Changes

git push https://x-access-token:<TOKEN>@github.com/username/repo.git main

Supported GitHub API Commands

Get User Information

GET /users/{username}

Get Repository Information

GET /repos/{owner}/{repo}

Create a New Branch

POST /repos/{owner}/{repo}/branches

Supported Code Search Commands

Search by Language

language:javascript

Search by Repository Path

repo:owner/name

Search by File Path

path:app/src

📚 Documentation

Personal Access Token Setup

Create a GitHub personal access token:

• Log in to your GitHub account and go to "Developer settings" > "Personal access tokens".
• Generate a new token and grant it the "repo" scope permission.

Docker Configuration Example

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

NPX Configuration Example

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

Image Building

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

Setup and Configuration

Personal Access Token

Create and configure a personal access token, ensuring it has appropriate permissions (e.g., the "repo" scope).

Integration with Claude Desktop

Add the GitHub MCP server configuration to claude_desktop_config.json.

📄 License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, but you must comply with the terms and conditions of the MIT License. For more details, please refer to the LICENSE file in the project repository.

👥 Contributors

Contributions are welcome! Please fork the repository and submit a Pull Request. If you have any questions, please open an issue in the Issues section.