Remote

Provides a remote MCP server with custom tools accessible via Cloudflare and local proxies.

typescript

0

GitHub Stars

typescript

Language

6 months ago

First Indexed

3 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": {
    "owanio1992-remote-mcp-server-authless": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:8787/sse"
      ]
    }
  }
}

You set up a remote MCP server that exposes your own tools and can be accessed from MCP clients without requiring authentication. This enables you to run your custom tools remotely, connect from the Cloudflare playground, and use a local client via a small proxy to access the server.

How to use

You can use this MCP server with any compatible MCP client to discover and run your tools remotely. Start by deploying the server to a cloud endpoint, then connect from the Cloudflare AI Playground to run tools directly from the browser. You can also wire up local clients to talk to the remote server through a small proxy, enabling tools to be invoked from your own development environment.

How to install

Prerequisites you need before installation: 
- Node.js and npm installed on your machine
- Access to a Cloudflare account if you plan to deploy to Cloudflare Workers
- Basic familiarity with running commands in a terminal

Step 1: Create and deploy the remote MCP server
- Run the command to create the MCP server project, using the Cloudflare template for the remote, authless MCP example:

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


Step 2: Deploy to Cloudflare Workers (optional)
- Open your Cloudflare deployment flow and deploy the project you created in Step 1. This will expose a URL similar to remote-mcp-server-authless.<your-account>.workers.dev/sse where your MCP server lives.

Additional content

Customize the server by adding your own tools. Edit the init() method in src/index.ts and define each tool with this.server.tool(...). This is how you extend the MCP server with capabilities that your users will discover and invoke from clients like the Cloudflare AI Playground or Claude Desktop.

Connect to the Cloudflare AI Playground to try your MCP server from a browser. Steps:

Go to the Cloudflare AI Playground
Enter your deployed MCP server URL (for example remote-mcp-server-authless.your-account.workers.dev/sse)
Use the available tools directly from the Playground interface

Connect Claude Desktop to your MCP server through the mcp-remote proxy. Use the example configuration to point Claude Desktop at your remote server via the built-in proxy. This enables your local client to access the remote tools through a local proxy.

Example Claude Desktop configuration you can adapt for your setup:

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


Restart Claude Desktop after updating the configuration to see the tools become available.

Available tools

calculator

Remote calculation tool exposed by the MCP server configuration for Claude Desktop access via mcp-remote proxy.