mcpserver

Overview ¶

Package mcpserver exposes the broker over the Model Context Protocol (stdio), so an AI agent can claim and release simulators as tool calls.

Two design points that come straight from the adversarial review:

• The agent must NOT pass the ephemeral `simbroker claim` invocation's pid as the holder — that process dies instantly and the claim would look dead. So the MCP server claims with ITS OWN pid (the long-lived session process), making this server the heartbeat owner for every claim it creates.
• A background goroutine renews those claims at TTL/3, independent of whether a tool call is currently blocking, so a busy agent never lets its lease lapse. On exit (stdin EOF / SIGINT / SIGTERM) the server releases them.