From eed90569f7dafa7eb9c8358c152efac1a49f0405 Mon Sep 17 00:00:00 2001 From: Tom Flux Date: Tue, 23 Jun 2026 21:16:30 +0100 Subject: Phase 3b: FastMCP "ai service" for claude.ai cooking mode A standalone MCP server (no Django import) exposing 7 tools over Streamable HTTP, backed by the Django REST API via the caine token. - mcp_server/: client.py (httpx wrapper over /api/), server.py (the tools + FastMCP app + main), __main__.py, tests.py. - Tools: get_pantry, set_item_state, add_to_pantry, what_can_i_cook, get_recipes, log_cook (suggests, never mutates), create_meta_recipe (brainstorm -> commit). Each description says when to call it. - deploy/food-mcp.service: systemd unit (own process, runs .venv python -m mcp_server, loads /var/lib/food/.env). - deploy/food.tomflux.xyz.nginx: current config + an authless /mcp// location proxying to 127.0.0.1:8765 (the URL secret is the credential; SSE-friendly buffering/timeout). - pyproject: [dependency-groups] mcp = [fastmcp, httpx]; deploy with `uv sync --group mcp`. Verified: 7 tools register on fastmcp 3.x, run() accepts transport/ host/port/path, 6 FoodClient unit tests pass (httpx MockTransport). Co-Authored-By: Claude Opus 4.8 --- mcp_server/__init__.py | 6 ++++++ 1 file changed, 6 insertions(+) create mode 100644 mcp_server/__init__.py (limited to 'mcp_server/__init__.py') diff --git a/mcp_server/__init__.py b/mcp_server/__init__.py new file mode 100644 index 0000000..07b8054 --- /dev/null +++ b/mcp_server/__init__.py @@ -0,0 +1,6 @@ +"""FastMCP "ai service" for the Food pantry app. + +A standalone process (no Django import) that exposes a small set of MCP tools to +claude.ai cooking mode over Streamable HTTP, backed by the Food Django REST API. +See mcp.md for the full specification. +""" -- cgit v1.2.3