MCP Server Modules

This page documents internal MCP server modules for contributor visibility. These underscored module paths are intentionally unstable.

Module entrypoint for built-in stdio MCP server.

Adapters between internal tool contracts and MCP JSON-RPC payloads.

design_research_agents._mcp_server._adapters.tool_result_to_mcp_payload(result)[source]

Convert one ToolResult into MCP tools/call response payload.

Parameters:

result – Internal tool invocation result.

Returns:

MCP-compatible tools/call response payload.

design_research_agents._mcp_server._adapters.tool_spec_to_mcp_payload(spec)[source]

Convert one ToolSpec into MCP tools/list payload shape.

Parameters:

spec – Internal tool specification to expose over MCP.

Returns:

MCP-compatible tools/list entry.

CLI helpers for built-in MCP server.

design_research_agents._mcp_server._cli.main()[source]

Stdio MCP server for CLI entrypoints.

Returns:

Process exit code (0 on normal shutdown).

Stdio MCP server exposing runtime tools.

class design_research_agents._mcp_server._server.StdioMcpServer(*, runtime=None)[source]

Minimal JSON-RPC MCP server over stdio.

Initialize the server with a runtime or default unified runtime.

Parameters:

runtime – Tool runtime used to list and invoke tools. Defaults to Toolbox.

serve(*, stdin, stdout)[source]

Serve until stdin closes.

Parameters:

  • stdin – Input stream carrying one JSON-RPC request per line.

  • stdout – Output stream used for JSON-RPC responses.