GeekyGramps-MCP

ステータス: アクティブ 作成日: 2026-07-01 所有者: Felton ビルダー: Codex (実装), Claude (アーキテクチャ/レビュー)

目的

FastifyベースのMCP（Model Context Protocol）ゲートウェイで、同じホームラボに対して作業する複数の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のみの公開、フェイルクローズのNetworkPolicy

注記

これは個人のホームラボツールであり、ポートフォリオ目的で公開されています。デプロイメント値（レジストリパス、サービス名、CIDR）はプレースホルダーです。実際のデプロイに使用される運用ランブックは、この特定の環境以外で再利用できるものではなく、実際のインフラストラクチャの詳細が含まれているため、非公開です。