Table of contents
Workbench MCP server
Personal tooling of one contributor, public repository. This optional Linux stdio server exposes owned jobs and retained evidence to agents. It is separate from Longshot's control bridge, CircleCI and Grafana.
Read the setup and configuration guide and tool catalogue. The documented runtime needs Python 3.12 or later and uv.
Connect a client
-
Review the workbench and its Linux prerequisites first. Its MCP adapters still target the predecessor runtime. The LS name does not establish compatibility with every Longshot executable or log.
-
From the checkout's
mcpdirectory, follow the locked installation recipe. Replace the interpreter placeholder with your own interpreter:export UV_CACHE_DIR="$PWD/../.uv-cache" export UV_PYTHON_INSTALL_DIR="$UV_CACHE_DIR/python" uv sync --locked --python /absolute/path/to/python3 -
Have the operator configure trusted tools, registered roots and catalogues as the README describes. Keep the private state root outside repositories. Protect all player installations and saves. Missing execution policy allows observation, not runs.
-
Add this documented stdio entry to an MCP-capable client. Every absolute path below is a placeholder to replace, not a directory to copy literally:
{ "mcpServers": { "ls-workbench": { "command": "uv", "args": ["run", "--locked", "--directory", "/absolute/path/to/workbench/mcp", "python", "-m", "src.main"], "env": { "UV_CACHE_DIR": "/absolute/path/to/workbench/.uv-cache", "UV_PYTHON_INSTALL_DIR": "/absolute/path/to/workbench/.uv-cache/python", "LS_WB_PROFILE": "observe" } } } } -
Read
workbench_statusandworkbench://tools. Start withobserve.operateexposes local mutations and runs, but does not grant resource-gate permission. Optional backends can remain unavailable.
What the tools cover
- Status: jobs, receipts and resource queues.
- Sessions: bounded disposable runs, inputs, state, settings, screenshots and shutdown.
- Checks: pinned build plans, gated builds, source checks and Windows-target syntax checks.
- Evidence: logs, faults, retained-run comparisons, analyses and labelled panels.
- Knowledge: registered skills/reports, retained nightly state and configured readers.
A Job is a submission, not a completed result. Read its receipt. Reconcile an uncertain reply before retrying. Images still need inspection; syntax checks are not Windows runtime tests.
The server cannot publish, push, sign in, read tokens, claim test requests, bypass gates, open game windows, execute arbitrary shell commands or export player saves. GitHub readers are not Forgejo readers. Stock team/request readers remain unavailable without the documented GET-only, no-save adapter. Isolation is not a filesystem or network sandbox.