Ein Plugin für Claude Code und Codex: Pydantic v2-Modelle, PEP 544-Protokolle und ein MCP-Server zur Verwaltung von GitHub Projects v2-Boards (z. B. github.com/users/<owner>/projects/<n>) – mit erstklassiger Unterstützung für die als Entwurf vorliegende HTTP QUERY-Methode.
server.py MCP server (mcp SDK v2, stdio) — 19 tools, structured output
│ depends on
protocols.py ProjectsBackend / GraphQLTransport (runtime-checkable Protocols)
│ implemented by
service.py GitHubProjectsService — GraphQL over the transport,
project-id + field caching, string→typed field-value coercion
graphql.py GraphQL documents (works for both user and org owners)
http.py QueryClient — HTTP QUERY (draft-ietf-httpbis-safe-method-w-body)
with per-origin capability memory and POST fallback
models.py Frozen Pydantic v2 models, __typename-discriminated unionsDie MCP-Ebene ist ausschließlich vom ProjectsBackend-Protokoll abhängig, sodass Backends austauschbar sind und Tests strukturell Fakes einsetzen.
QueryClient sendet QUERY optimistisch, erfasst Accept-Query-Ankündigungen, unternimmt bei Transportfehlern einen erneuten Versuch (QUERY ist sicher und idempotent) und fällt pro Origin bei 405/501 dauerhaft auf POST zurück – er funktioniert also bereits heute mit GitHub und aktualisiert sich selbst, sobald GitHub die QUERY-Unterstützung ausliefert.
Related MCP server: GitHub Project MCP Server
Die primäre Laufzeitumgebung ist CPython 3.14.7 free-threaded (3.14.7t). Außerdem muss die gh-CLI mit dem project-Scope authentifiziert sein:
gh auth refresh -s project # grants read + write for Projects v2Tokens werden aus GITHUB_TOKEN / GH_TOKEN ermittelt, andernfalls aus gh auth token.
uv sync
uv run pytest # 32 tests
uv run gh-projects-mcp # run the server on stdioVom Repository-Stammverzeichnis aus:
# Claude Code (registered user-wide)
claude mcp add --scope user github-projects -- uv --directory "$PWD" run gh-projects-mcp
# Codex
codex mcp add github-projects -- uv --directory "$PWD" run gh-projects-mcpPlugin-Manifeste befinden sich in .claude-plugin/plugin.json (wobei der MCP-Server über ${CLAUDE_PLUGIN_ROOT} deklariert ist) und .codex-plugin/plugin.json; ein Skill zur Nutzung für beide Hosts liegt in skills/github-projects/SKILL.md.
Tool | Zweck |
| Boards für einen Benutzer/eine Organisation auflisten (optional mit Suche) |
| Board anhand von Besitzer + Nummer |
| Felder inkl. Single-Select-Optionen und Iterationen |
| Elemente mit Inhalt + Feldwerten, optional über die Filterabfrage einer gespeicherten Ansicht ausgewertet |
| Board erstellen; Titel/README/Sichtbarkeit/Geschlossen-Status bearbeiten |
| Issue/PR per URL hinzufügen |
| Entwurfs-Issue hinzufügen |
| Feld setzen; Werte sind Zeichenketten, die anhand des Feldtyps umgewandelt werden – Single-Select und Iteration werden anhand des Namens abgeglichen ( |
| Feld leeren |
| Element archivieren oder entfernen |
| Idempotenter Soll-Zustands-Abgleich: Felder und Options-Aliase, semantisch verifizierte Blatt-/Container-Ansichten, geordnete Spalten, explizite Stilllegungen, Elementmetadaten, Epic-/Unter-Issue-Hierarchie, native Issue-Abhängigkeiten und Bereinigung veralteter Abhängigkeits-Beschreibungen |
| Statusspalten-Ansicht einer Iteration (oder aller Elemente + Bucket für Ungepl |
This server cannot be deployed
Operate GitHub from your AI assistant: repos, PRs, issues, Actions. Previews and read-only mode.
Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.
Manage Redbooth tasks, task lists, comments, tags and files from Claude and other AI assistants.
Task management for people and AI agents, with scoped OAuth access to issues, projects, and docs.
