Handbook
Example — MCP and Cursor
Choose the right integration surface:
Updated
Use case
Choose the right integration surface:
| Need | Start |
|---|---|
| Python code calls Playwright MCP | MCP client |
| Cursor invokes LCDL tools | MCP sidecar (overview) and MCP-SIDECAR (full) |
What it demonstrates
- Directionality — client (
forge_lcdl.mcp_client) vs sidecar exposing tasks to the IDE. - Workspace-root expectations — see
.cursor example configif present.
Example folder
examples/mcp/README.md — lists playwright_fetch_snapshot.py and policy notes.
Commands
pip install -e ".[dev]"
python -m compileall -q src
pytest -q tests -k mcp
Expected output
Offline tests pass where present; live Playwright MCP requires your Node/tooling stack.
Failure modes
- Wrong working directory — MCP configs often assume repo root.
- Mixed up client vs sidecar docs — re-read the two pages above.