Remote

Provides a remote MCP server that exposes tools to MCP clients via an HTTP SSE endpoint, enabling quick integration and testing.

typescript

0

GitHub Stars

typescript

Language

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

You can deploy a remote MCP server that exposes tools to MCP clients without requiring authentication. This server runs in the Cloudflare Workers environment and can be accessed by MCP clients to perform actions through the defined tools. It’s useful for quickly prototyping tools and making them available to remote clients via a simple HTTP/SSE endpoint.

How to use

Once your MCP server is deployed, you can connect to it from MCP clients to access the exposed tools. Key usage patterns include using the Cloudflare AI Playground as a remote MCP client and configuring local MCP clients to communicate with the remote server through an HTTP SSE endpoint.

How to install

Prerequisites you need before installing:
- Node.js and npm installed on your machine
- Access to a terminal or command prompt
- Optional: Cloudflare account if you plan to deploy to Cloudflare Workers

Step 1: Create the MCP server project

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

Step 2: Install dependencies and build/run as needed by the template

cd my-mcp-server
npm install
# Follow any template-specific build/start steps if provided by the template

Step 3: Deploy to Cloudflare Workers (if you choose the hosted route)

Use the deployment flow provided by the template to publish to your Cloudflare account
Obtain the deployed URL, which will resemble remote-mcp-server-authless.<your-account>.workers.dev/sse


## Additional content

Tools exposed by the MCP server are defined in the server’s initialization code. In this example, a tool named `calculator` is exposed as part of the MCP server configuration. You can extend the server by adding more tools in the `init()` method using `this.server.tool(...)`.

Connect to the server from Cloudflare AI Playground to test and experiment with your tools. In the Playground, enter your deployed MCP server URL (for example, remote-mcp-server-authless.your-account.workers.dev/sse) to start using your tools directly.

You can also connect a local MCP client, such as Claude Desktop, to your remote MCP server via the mcp-remote proxy. Use the following configuration example to enable access to the `calculator` tool from Claude Desktop.

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


## Available tools

### calculator

A remote calculator tool exposed by the MCP server for performing calculations via the mcp-remote proxy.