Remote

Deploy a remote MCP server on Cloudflare Workers that serves tools through an HTTP/stdio interface and works with MCP clients.

typescript

0

GitHub Stars

typescript

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You build a remote MCP server that runs on Cloudflare Workers and exposes a set of programmable tools you can invoke from MCP clients. It enables you to deploy, customize, and connect to tools remotely without needing a local server, making it easy to share capabilities across playgrounds, clients, and desktop apps.

How to use

Connect to your remote MCP server from any compatible MCP client to run tools that you’ve deployed. You can use the Cloudflare AI Playground to experiment with your MCP server or connect from local clients through a remote proxy setup.

How to install

Prerequisites you need before installation are Node.js and npm. If you don’t have them installed, download and install Node.js, which includes npm.

Install and bootstrap your MCP server project with the following command. This creates a new project using the remote MCP authless template.

npm create cloudflare@latest -- my-mcp-server --template=cloudflare/ai/demos/remote-mcp-authless

Additional sections

Customize your MCP server by editing the initialization file. To add your own tools, define each tool inside the init() method of src/index.ts using this.server.tool(...).

Connect to Cloudflare AI Playground to test your remote MCP server. Open the Playground, enter your deployed MCP server URL, and start using your tools directly from the playground.

If you want to use Claude Desktop or another local client, configure the MCP remote proxy to point at your remote server. Here is an example configuration you can place in Claude Desktop under Settings > Developer > Edit Config. The calculator tool will be accessible via the remote server.

{
  "mcpServers": {
    "calculator": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:8787/sse"  // or remote-mcp-server-authless.your-account.workers.dev/sse
      ]
    }
  }
}