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