Cloudflare Workers MCP

Add the Remote-MCP client to your project, or use it directly with npx without installing. The client acts as a local stdio-to-HTTP bridge between your MCP host and the remote server.

npm install @remote-mcp/client @trpc/client@next zod

Install the server package and implement your tools using the MCPRouter API. Deploy the resulting HTTP service to Cloudflare Workers, a VPS, or any reachable host. Note the public URL of the deployed service.

npm install @remote-mcp/server

On the server side, create an MCPRouter and register tools with input schemas. The framework serialises everything over HTTP so clients see standard MCP tool calls.

import { MCPRouter } from '@remote-mcp/server';
const router = new MCPRouter({ name: 'my-server', version: '1.0.0', capabilities: { logging: {} } });
router.addTool('add', { description: 'Add two numbers', inputSchema: { ... } }, async (input) => ({ result: input.a + input.b }));

Edit claude_desktop_config.json to add the Remote-MCP client as an MCP server entry. Set REMOTE_MCP_URL to your deployed endpoint and, if required, supply a Bearer token via HTTP_HEADER_Authorization.

{
  "mcpServers": {
    "remote-mcp": {
      "command": "npx",
      "args": ["-y", "@remote-mcp/client"],
      "env": {
        "REMOTE_MCP_URL": "https://your-worker.your-subdomain.workers.dev",
        "HTTP_HEADER_Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Restart Claude Desktop so it picks up the new MCP server configuration. Open a conversation and ask Claude to list available tools — you should see the tools registered on your remote server.