mcp-mnemose-kernels — Architecture

The @mnemose/mcp-mnemose-kernels package is a stdio-launched Model Context Protocol server exposing Mnemose kernel fleet tools to the agent loop. It is the agent’s interface to the remote agent-kernel fleet (list kernels, invoke tools on them).

Responsibilities

• Expose kernel.list and kernel.invoke MCP tools to the agent loop
• kernel.list — list enrolled agent-kernels for the current tenant (status, permission tier, capabilities)
• kernel.invoke — dispatch a JSON-RPC tool call to a target kernel via the kernel-broker

Key Components

File	Role
src/index.ts	Process entrypoint — boots the MCP server over stdio
src/server.ts	MCP server definition + ListTools / CallTool request handlers
src/tools.ts	Zod schemas for kernel.list / kernel.invoke tool inputs
src/worker.ts	Background dispatch worker (tool invocation fan-out)
src/tools.test.ts	Tool schema round-trip assertions

Dependencies

• @modelcontextprotocol/sdk
• zod + zod-to-json-schema
• @mnemose/kernel-protocol — JSON-RPC schemas dispatched to kernels

Data Flow

agent loop (loop-host)
  ↓ MCP stdio → mcp-mnemose-kernels server
  ↓ kernel.list → query enrolled kernels (read model)
  ↓ kernel.invoke → POST InvokeKernelTool → mnemose.commands Pub/Sub
kernel-broker
  ↓ JSON-RPC over mTLS WebSocket → agent-kernel