Skip to content

mcp-adapter

External-only MCP adapter stub exposing CLEO sentient operations as MCP tools. Does NOT wire into internal CLEO dispatch — external tools only.

build.protocol_tooling.mcp#cleo#mcp#model-context-protocol#sentient#adapter

Install mcp-adapter in your MCP client

mcp-adapter is a Model Context Protocol server. Add it to your MCP client config once, restart, and the server's tools become available to your AI assistant. The same JSON snippet below works across all four major clients — only the config file path differs.

  1. Locate your client's MCP config file.
    • Cursor: ~/.cursor/mcp.json
    • Claude Desktop (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json
    • Claude Desktop (Windows): %APPDATA%\Claude\claude_desktop_config.json
    • VS Code: Settings → Extensions → MCP
    • Windsurf: Settings → MCP Servers
  2. Add mcp-adapter to the mcpServers map — paste the snippet below into your config file. If you already have other MCP servers, merge the entry into the existing mcpServers object.
  3. Restart your client so it picks up the new server.
  4. Verify — ask the assistant to list available tools; mcp-adapter's tools should appear.
{
  "mcpServers": {
    "mcp-adapter": {
      "command": "npx",
      "args": [
        "-y",
        "@cleocode/mcp-adapter"
      ]
    }
  }
}

Install mcp-adapter in Cursor

Open ~/.cursor/mcp.json in your editor, paste the snippet above into mcpServers, save, and restart Cursor. mcp-adapter will show up in the assistant's tool list on next launch.

Install mcp-adapter in Claude Desktop (macOS)

Open ~/Library/Application Support/Claude/claude_desktop_config.json in your editor, paste the snippet above into mcpServers, save, and restart Claude Desktop (macOS). mcp-adapter will show up in the assistant's tool list on next launch.

Install mcp-adapter in Claude Desktop (Windows)

Open %APPDATA%\Claude\claude_desktop_config.json in your editor, paste the snippet above into mcpServers, save, and restart Claude Desktop (Windows). mcp-adapter will show up in the assistant's tool list on next launch.

Install mcp-adapter in VS Code

Open Settings → Extensions → MCP in your editor, paste the snippet above into mcpServers, save, and restart VS Code. mcp-adapter will show up in the assistant's tool list on next launch.

npm package: @cleocode/mcp-adapter

Transport

mcp-adapter supports the following MCP transports. Most AI clients use stdio by default for locally-installed servers.

stdio

From the mcp-adapter README

# @cleocode/mcp-adapter External-only MCP (Model Context Protocol) adapter that exposes CLEO sentient operations as MCP tools for consumption by external LLM clients and tools. > **Canon (DO NOT violate)**: CLEO is CLI-only internally. This adapter is EXTERNAL-ONLY — an export bridge that lets other tools (Claude Desktop, external MCP clients) consume a narrow slice of CLEO via MCP. It communicates with CLEO exclusively via `cleo` CLI subprocess calls. It does NOT import internal CLEO packages and is NOT part of CLEO's dispatch surface. > > **Do NOT** add MCP to internal CLEO dispatch. Do NOT import from `@cleocode/core` or any internal dispatch layer here. Do NOT add new tools by reaching into internal APIs — new tools MUST be exposed as `cleo` CLI verbs first, then mapped here as subpr

Other Model Context Protocol servers in the same space as mcp-adapter. Each one adds different capabilities to your AI assistant — pick based on the data sources or workflows you need.

Browse the full MCP server directory or use Stork's one-line install to let your agent pick the right server automatically.