home / mcp / template mcp server

Template MCP Server

Hosts remote MCP tools via HTTP or stdio proxy, enabling playground and desktop client access.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "algtools-mcp-template": {
      "url": "https://remote-mcp-server-authless.<your-account>.workers.dev/sse"
    }
  }
}

You can run a remote MCP server that hosts tools on Cloudflare Workers and access them from MCP clients. This setup lets you expose your tools via an HTTP endpoint or run them locally through a proxy, enabling you to use your tools from playgrounds or desktop clients with minimal wiring.

How to use

Connect to your remote MCP server from an MCP client to access tools hosted on Cloudflare. You can use the Cloudflare AI Playground to try your tools directly in a browser, or configure a local client to reach the server through a proxy. When you connect, you’ll see the available tools and can invoke them just as you would with any other MCP tool.

How to install

Prerequisites you need before you begin:

Node.js (version 14 or later)
npm (comes with Node.js)

Step-by-step commands to create and run the remote MCP server on Cloudflare:

# Create a new MCP server using the Cloudflare template for an authless remote setup
npm create cloudflare@latest -- my-mcp-server --template=cloudflare/ai/demos/remote-mcp-authless

Additional setup notes

Customize your MCP server by adding tools inside the init() method of src/index.ts using this.server.tool(...). This is where you define the capabilities you want to expose to MCP clients.

Connect to Cloudflare AI Playground

You can connect to your MCP server from the Cloudflare AI Playground, which acts as a remote MCP client. Open the Playground, then provide your deployed MCP server URL to start using your tools directly from the playground.

Connect Claude Desktop to your MCP server

You can also access your remote MCP server from Claude Desktop by configuring the MCP connection to point at the server. In Claude Desktop, go to Settings > Developer > Edit Config and enter the following structure, substituting your actual server URL for the placeholder.

{
  "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 wired through the mcp-remote proxy, exposed by the server to be invoked from MCP clients.