CF Design

You can run a remote MCP server that runs on Cloudflare Workers and expose tools to clients without requiring authentication. It’s useful for quick experimentation, demonstrations, or integrating tools into clients that don’t need user login flow. This guide shows how to connect to the remote server from an MCP client and how to run a local proxy client to access those tools.

How to use

Connect to your remote MCP server from any MCP client to start using the included tools. You can also link the remote server to local clients via a proxy so you run the server locally while the client accesses it remotely.

How to install

Prerequisites: you need Node.js and npm installed on your machine. You may also want a modern terminal or shell.

Install the MCP server tooling and bootstrap the remote server using your preferred method for Cloudflare Workers deployments. The process typically involves running a creation command that sets up a new MCP server instance in your account.

Optionally, you can start from an existing project template or example and customize the server by adding your own tools in the init() method of the server entry point.

Example deployment command style you might run locally includes using a project bootstrap tool to scaffold a remote MCP server, then deploying it to your Cloudflare Workers environment.

Configuration and usage notes

Two connection methods are demonstrated for this authless remote MCP server. The remote HTTP URL provides direct access to the server, while a local proxy workflow lets you run a lightweight client locally and connect to the remote endpoint.

{
  "mcpServers": {
    "remote_authless": {
      "type": "http",
      "name": "remote_authless",
      "url": "https://remote-mcp-server-authless.<your-account>.workers.dev/sse",
      "args": []
    },
    "calculator": {
      "type": "stdio",
      "name": "calculator",
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:8787/sse"
      ],
      "env": []
    }
  }
}

Examples and quickstart

If you want to run the local proxy to access the remote MCP server from a desktop client, use the same approach shown here: start the proxy tool and point it at the remote server URL. Then configure your client to connect to the local proxy endpoint.

Notes on customization and tools

Customize your MCP server by adding tools in the init() method of the server entry point. Each tool is registered with this.server.tool(...) so that clients can discover and use it. The example pattern shows how to introduce new tools into the server’s tool registry.