cleanroom-mcp#
The MCP server is the AI integration layer. It exposes MCP tools that AI agents (Hermes, Claude, Codex) can call to request cleanroom environments, submit jobs, and retrieve results — without any knowledge of the underlying infrastructure.
Responsibilities#
- Expose MCP tools over the MCP protocol
- Translate tool calls into HTTP API requests against the controller
- Return structured results (logs, artifacts, status) to the caller
Design constraints#
- Stateless — all state lives in the controller
- No business logic — routing and validation belong in the controller
- Must not require the caller to understand PXE, Buildroot, PoE, or worker lifecycle
MCP tools (planned)#
| Tool | Description |
|---|---|
submit_job | Submit a job script and return a job ID |
get_job_status | Poll a job by ID for status and progress |
get_job_logs | Retrieve stdout/stderr for a completed job |
list_workers | List registered workers and their current state |