home / mcp / remote mcp server

Remote MCP Server

Runs a remote MCP server and exposes it for local and cloud-based MCP clients.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "cyyzpanpan-remote-mcp-server": {
      "url": "http://localhost:8787/sse"
    }
  }
}

You can run a remote MCP server on Cloudflare Workers or locally, then connect MCP clients to explore, test, and drive tools from Claude or other MCP-capable interfaces. This guide covers running locally, inspecting with the MCP Inspector, connecting Claude Desktop, deploying to Cloudflare, and debugging.

How to use

Connect an MCP client to your server to explore available tools and run actions. Start by launching the local server, then use the MCP Inspector to discover endpoints and test tool calls. You can also configure Claude Desktop to talk to either your local or remote MCP server so you can invoke tools directly from Claude based on your prompts.

How to install

Prerequisites: ensure you have Node.js and npm installed on your machine.

Install dependencies and run the local remote MCP server.

# clone the repository
git clone [email protected]:cloudflare/ai.git

# install dependencies
cd ai
npm install

# run locally
npx nx dev remote-mcp-server
```

You should be able to open `http://localhost:8787/` in your browser

Additional content

Deploy and connect to remote MCP servers from Claude Desktop as described below. The following configurations illustrate how to point clients at a local server and at a deployed Cloudflare Worker endpoint.