home / mcp / remote mcp server

Remote MCP Server

Hosts a remote MCP server you can run locally or deploy to Cloudflare, enabling MCP clients to access tools via HTTP/SSE.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You can run a remote MCP server that other MCP clients connect to, either locally for development or deployed on Cloudflare Workers. This server supports tool access via SSE and can be integrated with clients like Claude Desktop for a seamless workflow.

How to use

You connect to your MCP server from an MCP client to access defined tools. Start with a local development instance to experiment, then deploy to Cloudflare for remote access. Use the MCP Inspector to explore the server and verify tools are available. You can also configure Claude Desktop to talk to either your local server or the remote Cloudflare endpoint.

How to install

Prerequisites you need before starting:

Node.js installed (recommended current LTS)
pnpm installed (you can install via npm install -g pnpm)
npm or npx available in your shell

Step-by-step local setup and run:

# clone the repository
git clone https://github.com/cloudflare/ai.git
# Or if using ssh:
# git clone [email protected]:cloudflare/ai.git

# install dependencies
cd ai
# Note: using pnpm instead of just "npm"
pnpm install

# run locally
npx nx dev remote-mcp-server

Additional content

Connecting to the server locally from an MCP client is straightforward via SSE at the local URL. You can also connect Claude Desktop by configuring its MCP proxy to point to your local server or to the remote Cloudflare endpoint once you deploy.

To connect Claude Desktop locally, use this configuration in Claude's settings: set the MCP server to run via the local SSE URL.