GitHub Tools MCP Server

Ein echter Model Context Protocol-Server, der Tools mit schreibgeschütztem Zugriff auf die GitHub-REST-API bereitstellt – in unter einer Minute in Claude Desktop oder Claude Code installierbar – plus eine separate Web-Demo, die dieselbe Tool-Logik über eine gewöhnliche Chat-Oberfläche nutzt.

Live-Demo: https://mcp-demo-phi.vercel.app/demo

Status: Was das ist und was nicht

Funktionsfähig und bereitgestellt. Alle 5 Tools wurden gegen echte GitHub-Daten verifiziert, 42 automatisierte Prüfungen in 3 Test-Suiten durchgeführt, und die vollständige App wurde auf der realen Produktions-URL als live bestätigt. Eine laufende, ehrliche Beschreibung jeder Entscheidung und jedes Bugs auf dem Weg findest du in DESIGN_LOG.md.

Die Web-Demo ist KEIN MCP-Transport. Sie ist ein schlichtes FastAPI, das dieselben tools.py-Funktionen direkt als Python aufruft, statt das MCP-Protokoll zu sprechen. Eine wirklich nützliche Unterscheidung, die man präzise treffen sollte – siehe Abschnitt 3 von DESIGN_LOG.md, warum hier kein echter Remote-MCP-Transport versucht wird.

Related MCP server: GitHub MCP Connector

Architektur

                    ┌─────────────────────┐
                    │      tools.py        │  <- 5 pure functions, no
                    │  (GitHub REST calls   │     MCP-specific code
                    │   via github_client)   │
                    └──────────┬───────────┘
                               │
              ┌────────────────┴────────────────┐
              │                                  │
    ┌─────────▼─────────┐            ┌───────────▼──────────┐
    │     server.py       │            │     api/index.py       │
    │  MCPServer, stdio    │            │  FastAPI, POST /chat    │
    │  transport            │            │  real Claude tool-      │
    │  -> Claude Desktop/    │            │  calling loop over       │
    │     Claude Code        │            │  the same tools           │
    └─────────────────────┘            └────────────────────────┘
     THE MCP SERVER                      A PLAIN HTTP DEMO OF
     (the real deliverable)              THE SAME TOOL LOGIC

Einrichtung

cp .env.example .env   # GITHUB_TOKEN (both halves), ANTHROPIC_API_KEY (web demo only)
pip install -r requirements.txt

MCP-Server lokal ausführen

python3 server.py

Zu Claude Desktop hinzufügen: Bearbeite %APPDATA%\Claude\claude_desktop_config.json (Windows) bzw. ~/Library/Application Support/Claude/claude_desktop_config.json (macOS), übernimm den Inhalt von claude_desktop_config.example.json (trage dein echtes GITHUB_TOKEN und den absoluten Pfad zu server.py ein) und starte Claude Desktop anschließend neu. Zu Claude Code hinzufügen: Führe claude mcp add aus oder bearbeite die .mcp.json deines Projekts auf dieselbe Weise.

Manueller interaktiver Entwicklungs-Workflow: Das SDK bringt einen Inspector mit, mit dem man den Server ohne vollständigen Client von Hand untersuchen kann – npx @modelcontextprotocol/inspector python3 server.py.

Web-Demo lokal ausführen

export $(cat .env | xargs)
uvicorn api.index:app --reload --port 8020

Design-Protokoll

Jede nicht offensichtliche Entscheidung sowie die SDK-API-Oberfläche, die gegen das tatsächlich installierte Paket verifiziert statt aus möglicherweise veralteter Dokumentation übernommen wurde, findet sich in DESIGN_LOG.md.