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 --- pyproject.toml | 8 ++++++++ 1 file changed, 8 insertions(+) (limited to 'pyproject.toml') diff --git a/pyproject.toml b/pyproject.toml index d09d09a..e0340ed 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -14,3 +14,11 @@ dependencies = [ # No [build-system]: this is an application, not an installable package, so uv # treats it as a virtual project and won't try to build/install it. + +# Optional deps for the MCP "ai service" (deploy with `uv sync --group mcp`). +# Kept out of the default set so the Django service stays lean. +[dependency-groups] +mcp = [ + "fastmcp>=2", + "httpx>=0.27", +] -- cgit v1.2.3