github-mcp

MCP-Server für die GitHub REST API — 1.112 Tools, die alle 44 API-Kategorien abdecken.

Automatisch generiert aus GitHubs OpenAPI-Spezifikation mithilfe eines Codegenerators, der typisierte Tool-Definitionen mit Zod-Validierung erstellt.

Installation

npm install github-rest-mcp

Oder über GitHub Packages:

npm install @eyalm321/github-mcp

Konfiguration

Legen Sie Ihr GitHub Personal Access Token fest:

export GITHUB_TOKEN=ghp_your_token_here

Kategoriefilter

Standardmäßig sind alle 1.112 Tools registriert. Um nur bestimmte Kategorien zu aktivieren:

export GITHUB_MCP_CATEGORIES=repos,issues,pulls,actions

Claude Desktop

Fügen Sie dies zu Ihrer claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "github-rest-mcp"],
      "env": {
        "GITHUB_TOKEN": "ghp_your_token_here",
        "GITHUB_MCP_CATEGORIES": "repos,issues,pulls,actions,users,orgs,git,search"
      }
    }
  }
}

API-Kategorien

Tool-Benennung

Tools folgen dem Muster github_{kategorie}_{aktion}, abgeleitet von GitHubs Operations-IDs:

• github_repos_get — Ein Repository abrufen

• github_issues_create — Ein Issue erstellen

• github_pulls_list — Pull Requests auflisten

• github_actions_list_workflow_runs — Workflow-Ausführungen auflisten

Entwicklung

# Install dependencies
npm install

# Regenerate tools from OpenAPI spec
npm run generate

# Build
npm run build

# Run tests
npm test

# Start the server
npm start

Tools neu generieren

Die Tool-Dateien in src/tools/ werden automatisch aus GitHubs OpenAPI-Spezifikation generiert. Zum Aktualisieren:

# Delete cached spec to force re-download
rm -f api-description.json

# Regenerate
npm run generate

Lizenz

MIT