Remote

You can run a remote MCP Server on Cloudflare Workers and connect it to MCP clients like Claude Desktop or the MCP Inspector. This setup lets you host your MCP endpoints remotely while still testing locally and securely authenticating users with OAuth when deployed.

How to use

Set up your MCP server locally, connect the MCP Inspector to explore your API, and then wire Claude Desktop to the local proxy or to your deployed workers URL. You can switch between testing locally and running a remote server in the cloud to enable OAuth login and remote access.

Use the MCP Inspector to see available tools and execute them against your server. Start the inspector, point it to your MCP server’s SSE URL, log in with any email/password, and you’ll be able to list and call the defined tools.

How to install

// Prerequisites: ensure you have Node.js and npm installed on your system.
// 1) Clone the MCP server project
git clone https://github.com/cmsparks/remote-mcp-server-2.git

// 2) Install dependencies
cd remote-mcp-server-2
npm install

// 3) Run the server locally for development
npx nx dev remote-mcp-server

Additional notes and setup guidance

Connect the MCP inspector to your local server by starting the inspector and configuring the SSE transport to the server’s /sse endpoint. This enables a mock login flow and tool discovery for testing.

Configure Claude Desktop to talk to your local MCP server by creating a configuration that proxies through a local command. The example configuration below runs a local proxy that forwards to the MCP server’s SSE URL.

{
  "mcpServers": {
    "remote_mcp": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:8787/sse"
      ]
    }
  }
}

Deploying to Cloudflare takes a few steps to enable OAuth and remote access. Create the KV namespace, update the runtime configuration, and deploy the project.

1. npx wrangler@latest kv namespace create remote-mcp-server-oauth-kv
2. Follow the prompts to add the kv namespace ID to wrangler.jsonc
3. npm run deploy

Troubleshooting and debugging

If you run into issues, restart Claude or connect directly to the MCP server from the command line to verify the endpoint is reachable. You can also clear local authentication state if needed.

npx mcp-remote http://localhost:8787/sse

Available tools

MCP Inspector

A tooling utility to connect to an MCP server over SSE, explore available tools, and execute them in a sandboxed session.

mcp-remote

A CLI proxy used by clients like Claude Desktop to forward commands to the MCP server over SSE.