Skip to content

The fastest, cheapest, most efficient open-source agent harness. Run more than 500 agents on a $10 VPS.

4.8 KB
Raw Blame

description: >- How OpenHuman connects MCP servers, applies product policy, and exposes their tools to agents through TinyBus modules. icon: plug

MCP registry

crates/openhuman-core/src/mcp/registry/ is OpenHuman's host adapter for the Model Context Protocol (MCP) client. It preserves the mcp_clients RPC and agent-tool surfaces while the TinyMCP module owns registry and connection behavior. The module is loaded through TinyBus; OpenHuman uses the published tinymcp-bus vocabulary and does not link the TinyMCP implementation into its normal dependency graph.

The Registry tab browses the supported catalogs and adds servers through the user's mcp.json document. There is no install-from-catalog RPC or agent install tool. A simple hosted server can be declared in one click; other servers are declared from their own setup instructions. The existing mcp_clients.* RPC names and persisted mcp_clients name remain stable.

Ownership and request flow

Frontend / agent tools
        │  mcp_clients RPCs and MCP tool calls
        ▼
OpenHuman host adapters
  product config, credentials, proxy policy, approvals,
  prompt-injection admission, RPC outcomes and domain events
        │  typed TinyBus calls
        ▼
TinyMCP module
  catalogs, mcp.json reconciliation, stores, connections,
  OAuth protocol, tool preparation, transports and supervisor

mcp::host converts OpenHuman configuration to McpClientConfig and applies the product proxy and endpoint credential policy. mcp::module_client owns the configured module object for each workspace, serializes access to its private object path, and retains open/close transition receipts so a retry can finish lifecycle work after cancellation or a lost reply. Configuration sent to the module uses confidential TinyBus delivery.

The registry controllers keep the public mcp_clients_* RPC contract, translate module results into OpenHuman outcomes, and publish OpenHuman domain events. The host also owns product permission and exposure mapping and the prompt-injection scan applied before remote tools are offered to an agent. The module prepares stable tool names, schemas, and metadata; execution and protocol handling stay inside the module.

Server transports

An installed server's typed Transport is either a local subprocess speaking stdio JSON-RPC or an HTTP-remote endpoint. TinyMCP owns transport startup, protocol, connection state, and cleanup. OpenHuman decides which server configuration and credentials are approved and passes them over the bus.

The same ownership split applies when OpenHuman acts as an MCP server. The TinyMCP module owns protocol sessions, stdio framing, Streamable HTTP admission, and response metadata. OpenHuman keeps the curated tool catalog, security policy, RPC dispatch, and typed host callbacks. For HTTP DELETE, the host retires its local session and aborts and joins any running callback only after the module accepts the request; a rejected DELETE leaves the session usable. Session close and process shutdown drain callback work before releasing its local handle.

Host layout

Path Responsibility
crates/openhuman-core/src/mcp/host.rs Product configuration conversion, proxy selection, and OAuth redirect URL.
crates/openhuman-core/src/mcp/module_client.rs Workspace-scoped configured object lifecycle and typed/confidential bus calls.
registry/ops.rs, config_ops.rs, schemas/ Stable RPC handlers, mcp.json adapter, and controller schemas.
registry/action_tool.rs, registry/tools.rs Deferred host tool adapters, product admission, and execution event mapping.
registry/supervisor_events.rs, registry/bus.rs Convert module reports and lifecycle events to OpenHuman domain events.
audit/ OpenHuman RPC surface over module-owned MCP write-audit records.
server/ OpenHuman's tool catalog, security policy, and typed callbacks for the local MCP server.

Security and compatibility

  • Keep credentials in OpenHuman's configuration and credential stores. Use confidential bus methods whenever calls carry credentials or other sensitive tool data; ordinary module calls must not carry secrets.
  • Preserve the existing mcp_clients.* RPC names and user-visible server names. Bus DTOs and member names come from tinymcp-bus; do not define local wire copies.
  • Keep product policy in OpenHuman and generic MCP protocol, transport, catalog, persistence, and tool-preparation behavior in vendor/tinymcp.
  • Do not put user data, credentials, provider responses, or raw tool arguments in analytics or logs. Use the shared endpoint redactor for endpoint logging.

For implementation details, see the MCP server and crates/openhuman-core/src/mcp/README.md.