@open-probe/mcp-server

A standalone MCP (Model Context Protocol) server for open-probe. Speaks two protocols against the same in-memory store:

• HTTP REST + SSE — what the browser-side createMcpTransport posts to.
• stdio MCP — what AI agents (Cursor, Continue, Cline, Zed, Claude Desktop, Roo Code, etc.) connect to via mcp.json.

Ships 10 MCP tools (list/get/watch sessions, list/get pending annotations, acknowledge, etc.) backed by an event bus so SSE clients and stdio agents see the same stream of annotations.

Install

pnpm add -D @open-probe/mcp-server

Run

# HTTP only (what `@open-probe/core`'s mcp transport hits)
npx open-probe-mcp http --port 3100

# stdio MCP for an AI agent (configured in mcp.json)
npx open-probe-mcp stdio

mcp.json snippet

{
  "mcpServers": {
    "open-probe": {
      "command": "npx",
      "args": ["-y", "@open-probe/mcp-server", "stdio"]
    }
  }
}

Tools

| Tool | Purpose | |------|---------| | list_sessions / get_session | session metadata | | list_pending / get_pending | unacked annotations | | acknowledge_annotation | mark as processed | | watch_annotations | long-poll until a new annotation arrives | | list_recent | history of acked annotations | | clear_session | drop everything for a session id | | health / info | diagnostics |

See the project README for the full integration story.

License

MIT