GeekyGramps-MCP

状态：活跃 创建：2026-07-01 所有者：Felton 构建者：Codex（实现）、Claude（架构/审查）

目的

一个基于 Fastify 的 MCP（Model Context Protocol）网关，为在同一个 homelab 上工作的多个 AI 编码代理（Claude Code、Codex、Antigravity）提供共享的、项目级作用域的内存。由 PostgreSQL 支撑，除健康检查外的每条路由都执行每次请求的令牌校验，密钥通过 Infisical CRD 交付，而不是硬编码到配置中。

构建目的是让多个代理可以读写共享的项目内存存储而不会互相干扰，而不是每个代理各自维护自己孤立的上下文。

Related MCP server: iranti

结构

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

技术栈

• 运行时： Node.js、Fastify

• 存储： PostgreSQL

• 协议： Model Context Protocol（@modelcontextprotocol/sdk）

• 密钥： Infisical（基于 Kubernetes CRD 的同步）

• 部署目标： k3s，仅通过 NodePort 暴露，默认拒绝（fail-closed）的 NetworkPolicy

备注

这是一个个人 homelab 工具，为作品集目的而发布。部署值（registry 路径、服务名称、CIDR）是占位符——实际用于部署此工具的运维手册保持私有，因为它包含的是实际基础设施细节，而不是可在该特定环境之外复用的任何内容。