home / mcp / remote mcp server

Remote MCP Server

Provides a remote MCP server accessible over Cloudflare Workers, with local development, inspector tooling, and Claude Desktop integration.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You can run a remote MCP server on Cloudflare Workers, develop against it locally, connect with the MCP Inspector, and deploy it for remote access. This guide walks you through practical usage, installation steps, and key configurations so you can start experimenting quickly and securely.

How to use

Connect your MCP client to a local MCP server to explore tools and capabilities. Start the local server, open the MCP Inspector, and attach to the server’s SSE endpoint to begin testing tools. You can also bridge this local server to Claude Desktop by using a small local proxy configuration, then deploy a Cloudflare-based remote server and connect Claude to that remote endpoint.

How to install

Prerequisites you need before getting started:

Node.js installed (LTS version)
pnpm installed (recommended)
Git installed

Step by step commands to set up and run locally:

# 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 setup and notes

Local development overview: You can access the local server at http://localhost:8787/. This server provides a remote MCP endpoint you can test against with the MCP Inspector.

Additional sections

Configuration and deployment steps give you a path from local testing to a public remote server. Use the following steps to deploy to Cloudflare and then connect clients remotely.

Troubleshooting and debugging

If you run into issues, restart the client and server, and verify you’re connecting to the correct SSE endpoint. You can also try a direct command-line check with the remote MCP client to verify the local endpoint is responding.

Available tools

mcp_inspector

MCP Inspector tool used to explore and test MCP APIs by connecting to the MCP server via SSE and invoking defined tools.

mcp-remote

Command-line proxy used to connect Claude Desktop to an MCP server by forwarding calls to the remote SSE endpoint.