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/<secret>/ 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 <noreply@anthropic.com>
This commit is contained in:
co-authored by
Claude Opus 4.8
parent
7255c9302c
commit
44de784f70
@@ -0,0 +1,85 @@
|
||||
"""Tests for the FoodClient HTTP layer, using httpx.MockTransport (no network,
|
||||
no Django, no fastmcp). Run with: python -m unittest mcp_server.tests
|
||||
"""
|
||||
import json
|
||||
import unittest
|
||||
|
||||
import httpx
|
||||
|
||||
from mcp_server.client import FoodClient, FoodApiError
|
||||
|
||||
|
||||
def make_client(handler):
|
||||
transport = httpx.MockTransport(handler)
|
||||
http = httpx.Client(
|
||||
transport=transport,
|
||||
base_url="http://api.test/api",
|
||||
headers={"Authorization": "Token x"},
|
||||
)
|
||||
return FoodClient(http=http)
|
||||
|
||||
|
||||
class FoodClientTests(unittest.TestCase):
|
||||
def test_set_state_posts_expected_body(self):
|
||||
captured = {}
|
||||
|
||||
def handler(request):
|
||||
captured["path"] = request.url.path
|
||||
captured["body"] = json.loads(request.content)
|
||||
return httpx.Response(200, json={"state": "out"})
|
||||
|
||||
out = make_client(handler).set_state("noodles", "out", location="cupboard")
|
||||
self.assertEqual(captured["path"], "/api/pantry/set-state/")
|
||||
self.assertEqual(
|
||||
captured["body"],
|
||||
{"ingredient": "noodles", "state": "out", "location": "cupboard"},
|
||||
)
|
||||
self.assertEqual(out["state"], "out")
|
||||
|
||||
def test_set_state_omits_location_when_absent(self):
|
||||
captured = {}
|
||||
|
||||
def handler(request):
|
||||
captured["body"] = json.loads(request.content)
|
||||
return httpx.Response(200, json={})
|
||||
|
||||
make_client(handler).set_state("eggs", "in")
|
||||
self.assertNotIn("location", captured["body"])
|
||||
|
||||
def test_bulk_add_wraps_items(self):
|
||||
captured = {}
|
||||
|
||||
def handler(request):
|
||||
captured["body"] = json.loads(request.content)
|
||||
return httpx.Response(201, json={"added": 1})
|
||||
|
||||
make_client(handler).bulk_add([{"ingredient_name": "eggs"}])
|
||||
self.assertEqual(captured["body"], {"items": [{"ingredient_name": "eggs"}]})
|
||||
|
||||
def test_what_can_i_cook_passes_servings(self):
|
||||
captured = {}
|
||||
|
||||
def handler(request):
|
||||
captured["servings"] = request.url.params.get("servings")
|
||||
return httpx.Response(200, json={"results": []})
|
||||
|
||||
make_client(handler).what_can_i_cook(servings=4)
|
||||
self.assertEqual(captured["servings"], "4")
|
||||
|
||||
def test_error_response_raises(self):
|
||||
def handler(request):
|
||||
return httpx.Response(404, json={"error": "nope"})
|
||||
|
||||
with self.assertRaises(FoodApiError):
|
||||
make_client(handler).set_state("x", "out")
|
||||
|
||||
def test_unreachable_api_raises(self):
|
||||
def handler(request):
|
||||
raise httpx.ConnectError("boom")
|
||||
|
||||
with self.assertRaises(FoodApiError):
|
||||
make_client(handler).pantry()
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
unittest.main()
|
||||
Reference in New Issue
Block a user