mcp-github-extras

Extended GitHub tools for Model Context Protocol (MCP) — filling the gaps left by the official github-mcp server.

Quick Start

# Install globally
npm install -g mcp-github-extras

# Configure in Claude Desktop (~/.claude/claude_desktop_config.json)
{
  "mcpServers": {
    "github-extra": {
      "command": "npx",
      "args": ["mcp-github-extras"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_your_token_here"
      }
    }
  }
}

# Restart Claude Desktop and start using the tools!

Why this exists

The official github-mcp server covers most GitHub operations but is missing several PR workflow tools essential for automation pipelines:

| Missing operation | GitHub API endpoint | |-------------------|-------------------| | Add PR reviewers | POST /pulls/{n}/requested_reviewers | | Add PR assignees | PATCH /issues/{n} | | Set PR labels | POST /issues/{n}/labels | | List repo tags | GET /repos/{owner}/{repo}/tags | | Create label | POST /repos/{owner}/{repo}/labels |

mcp-github-extras fills exactly these gaps. It is designed to run alongside the official server, not replace it.

Tools

| Tool | Description | |------|-------------| | list_tags | List the latest git tags for a repository | | add_pr_reviewers | Request reviewers on an existing pull request | | add_pr_assignees | Set assignees on an existing pull request | | set_pr_labels | Add or replace labels on an existing pull request | | create_label | Create a label in a repository if it does not exist |

Requirements

• Node.js 18+
• A GitHub personal access token with repo scope

Installation

Option 1: Install from npm (Recommended)

npm install -g mcp-github-extras

Option 2: Install from source

git clone https://github.com/vidhya03/mcp-github-extras
cd mcp-github-extras
npm install
cp .env.example .env
# edit .env and add your GITHUB_PERSONAL_ACCESS_TOKEN

Configuration

Global — ~/.claude/claude_desktop_config.json

Using npm package:

{
  "mcpServers": {
    "github-extra": {
      "command": "npx",
      "args": ["mcp-github-extras"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_your_token_here"
      }
    }
  }
}

Using source installation:

{
  "mcpServers": {
    "github-extra": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-github-extras/index.js"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_your_token_here"
      }
    }
  }
}

Project level — .mcp.json

Using npm package:

{
  "mcpServers": {
    "github-extra": {
      "command": "npx",
      "args": ["mcp-github-extras"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_PERSONAL_ACCESS_TOKEN}"
      }
    }
  }
}

Using source installation:

{
  "mcpServers": {
    "github-extra": {
      "command": "node",
      "args": ["./mcp-github-extras/index.js"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_PERSONAL_ACCESS_TOKEN}"
      }
    }
  }
}

Keep the official github-mcp registered separately under the name github. Both servers can run side by side without conflict as long as they have distinct names.

Usage

Once configured, the tools are available to any MCP client (Claude Desktop, Cline, etc.). The server exposes 5 tools that complement the official GitHub MCP server:

• list_tags - Get repository tags for version tracking
• add_pr_reviewers - Request code reviews on pull requests
• add_pr_assignees - Assign pull requests to team members
• set_pr_labels - Organize PRs with labels
• create_label - Create repository labels programmatically

These tools work alongside the official github-mcp server to provide complete GitHub workflow automation through MCP.

Tool reference

list_tags

{
  "owner":    "vidhya03",
  "repo":     "mcp-github-extras",
  "per_page": 10
}

add_pr_reviewers

{
  "owner":       "vidhya03",
  "repo":        "my-repo",
  "pull_number": 42,
  "reviewers":   ["teammate1", "teammate2"]
}

add_pr_assignees

{
  "owner":       "vidhya03",
  "repo":        "my-repo",
  "pull_number": 42,
  "assignees":   ["vidhya03"]
}

set_pr_labels

{
  "owner":       "vidhya03",
  "repo":        "my-repo",
  "pull_number": 42,
  "labels":      ["cve-remediation", "severity:critical"],
  "replace":     true
}

create_label

{
  "owner":       "vidhya03",
  "repo":        "my-repo",
  "name":        "severity:critical",
  "color":       "d73a4a",
  "description": "CVE with CVSS score 9.0+"
}

Running locally

GITHUB_PERSONAL_ACCESS_TOKEN=ghp_xxx node index.js

You should see:

github-extra-mcp running

Contributing

PRs welcome. If you find another gap in the official github-mcp toolset, open an issue and we can add it here.

License

MIT © Vidhya