mcp-nutrition-db

mcp-nutrition-db は、ChatGPT が食事の栄養と栄養目標を記録・修正・照会できるようにするプライベート MCP サービスです。ChatGPT は食事の写真と会話のコンテキストを解釈し、このサービスが永続的で監査可能なデータを保持します。

本番サービスは NixOS ホスト kage 上で実行されることを想定しています。ループバックのみで待ち受け、OpenAI Secure MCP Tunnel を通じて ChatGPT から到達するため、nginx のルートや公開 MCP エンドポイントは不要です。

プロジェクトドキュメント

• システム設計 は、プロダクトの境界、MCP ツール、データモデル、セキュリティモデル、NixOS デプロイを定義します。

• 実装計画 は、フェーズ、受け入れ基準、進捗、先送りされた作業の信頼できる情報源です。

• ローカルテスト は、Codex への直接アタッチと、ChatGPT Web 向けの一時的な Secure MCP Tunnel ワークフローについて説明します。

実装計画は、意味のある実装マイルストーンと同じコミットで更新する必要があります。設計変更は、それに依存するコードの前、またはコードと併せて決定ログに記録する必要があります。

Related MCP server: Nutrition MCP Server

現在の状況

ローカル MVP は、SQLite スキーマと全 8 つの MCP ツールを実装しています。リポジトリ、スキーマ、カレンダー、MCP プロセス、Streamable HTTP、パッケージ、NixOS 評価の各チェックがパスします。正確な検証済み状態については、実装計画を参照してください。

開発

固定された環境に入り、チェックを実行します:

nix develop
PYTHONPATH=src ruff format --check src tests
PYTHONPATH=src ruff check src tests
PYTHONPATH=src mypy src
PYTHONPATH=src pytest

使い捨て可能な状態でループバック開発サーバーを実行します:

nix run . -- serve --database /tmp/mcp-nutrition-db.sqlite3

MCP エンドポイントは http://127.0.0.1:8787/mcp で、readiness は http://127.0.0.1:8787/healthz で確認できます。サーバーはデフォルトでループバック以外の HTTP バインドを拒否します。新しい Codex セッションをアタッチするか、ChatGPT Web 用の固定されたトンネルクライアントを実行するには、ローカルテスト を参照してください。