mermate-openclaw-mcp
Use when the user wants to build, extend, or debug the Python MCP bridge that exposes Mermate actions and stage flows to OpenClaw or other MCP clients.
SKILL.md.agents/skills/mermate-openclaw-mcp/SKILL.md
GitHubMermate OpenClaw MCP
Treat the Express API as the source of truth. The MCP layer should stay thin and map directly onto real routes.
Files to inspect first:
mcp_service/server.pymcp_service/client.py.mcp.jsonserver/routes/render.jsserver/routes/tla.jsserver/routes/ts.jsserver/routes/agent.jsserver/routes/search.jsserver/routes/transcribe.js
Build rules:
- Keep stage parity with the live pipeline: render -> TLA+ -> TypeScript, plus
agent/runandagent/finalize. - When a new Mermate route is added, add or update a matching MCP tool instead of inventing a synthetic workflow first.
- Keep HTTP transport logic in
mcp_service/client.py; keep tool definitions inmcp_service/server.py. - For SSE routes, preserve stage transitions and terminal events. Do not drop
preview_ready,final_render,done, orerror. - Normalize
markdowntomdat the bridge boundary so clients can use human-friendly input while Mermate keeps its native mode values. - Use resources for stable reference material like the stage map or tool-to-route map.
Expected stage mapping:
/api/render->mermate_render/api/render/tla->mermate_render_tla/api/render/ts->mermate_render_ts/api/agent/run->mermate_agent_run/api/agent/finalize->mermate_agent_finalize/api/projects/:id/pipeline->mermate_get_project_pipeline
OpenClaw integration rules:
- Keep the repo-level
.mcp.jsonpointing at the repo-local.venv-mcp/bin/python -m mcp_servicecommand on this machine. - Use
MERMATE_URLfor the sidecar base URL; default tohttp://127.0.0.1:3333. - If the repo moves, update the absolute
commandandcwdvalues in.mcp.json. - Prefer additive tool coverage over changing existing tool names, because wrapper prompts may already depend on them.
Verification:
python3 -m unittest test/test_mermate_mcp_service.pypython3 -m compileall mcp_servicePYTHONPATH=/tmp/mermate_mcp_inspect:. python3 -c "from mcp_service.server import mcp; print(mcp.name)"