GeekyGramps-MCP

Estado: activo Creado: 2026-07-01 Propietario: Felton Constructor: Codex (implementación), Claude (arquitectura/revisión)

Propósito

Una pasarela MCP (Model Context Protocol) basada en Fastify que proporciona memoria compartida y limitada al proyecto a múltiples agentes de codificación de IA (Claude Code, Codex, Antigravity) que trabajan contra el mismo homelab. Respaldada por PostgreSQL, con aplicación de tokens por solicitud en cada ruta excepto una comprobación de salud, y secretos entregados mediante un CRD de Infisical en lugar de estar incrustados en la configuración.

Construida para que varios agentes puedan leer/escribir un almacén de memoria de proyecto común sin pisarse unos a otros, en lugar de que cada agente mantenga su propio contexto desconectado.

Related MCP server: iranti

Estructura

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

• Tiempo de ejecución: Node.js, Fastify

• Almacenamiento: PostgreSQL

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

• Secretos: Infisical (sincronización basada en CRD de Kubernetes)

• Destino de despliegue: k3s, exposición solo mediante NodePort, NetworkPolicy de cierre ante fallos

Notas

Esta es una herramienta personal de homelab, publicada con fines de portafolio. Los valores de despliegue (ruta del registro, nombres de servicios, CIDRs) son marcadores de posición: el runbook operativo utilizado para desplegar esto realmente se mantiene privado, ya que contiene detalles de infraestructura en vivo en lugar de algo reutilizable fuera de este entorno específico.