GeekyGramps-MCP

Status: aktiv Erstellt: 2026-07-01 Besitzer: Felton Builder: Codex (Implementierung), Claude (Architektur/Review)

Zweck

Ein auf Fastify basierendes MCP-Gateway (Model Context Protocol), das mehreren KI-Coding-Agenten (Claude Code, Codex, Antigravity), die gegen dasselbe Homelab arbeiten, einen gemeinsamen, projektspezifischen Speicher bereitstellt. Unterstützt durch PostgreSQL, mit pro Anfrage durchgesetzter Token-Begrenzung auf jeder Route außer einem Health-Check, und Geheimnisse, die über ein Infisical-CRD geliefert werden, statt in die Konfiguration eingebacken zu sein.

Entwickelt, damit mehrere Agenten einen gemeinsamen Projekt-Speicher lesen und schreiben können, ohne sich gegenseitig zu stören, anstatt dass jeder Agent seinen eigenen getrennten Kontext behält.

Related MCP server: iranti

Struktur

src/       Fastify server, DB access, project-key validation, tool policy enforcement
scripts/   DB provisioning/init, MCP reachability diagnostics, agent tmux session launcher, request router
test/      Node built-in test coverage for the token gate, tool policy, and project-key validation
deploy/    k3s app-template values, Infisical secret CRD, fail-closed NetworkPolicy

Stack

• Laufzeit: Node.js, Fastify

• Speicher: PostgreSQL

• Protokoll: Model Context Protocol (@modelcontextprotocol/sdk)

• Geheimnisse: Infisical (Kubernetes-CRD-basierte Synchronisierung)

• Bereitstellungsziel: k3s, nur NodePort-Exposition, fail-closed NetworkPolicy

Hinweise

Dies ist ein persönliches Homelab-Tool, das zu Portfoliozwecken veröffentlicht wird. Bereitstellungswerte (Registry-Pfad, Dienstnamen, CIDRs) sind Platzhalter – das operative Runbook, das für die tatsächliche Bereitstellung verwendet wird, wird privat gehalten, da es Live-Infrastrukturdaten enthält und nichts enthält, das außerhalb dieser spezifischen Umgebung wiederverwendbar wäre.