Starbucks

Provides a remote MCP server over Cloudflare Workers to run tools via SSE.

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": {
    "mike-pete-starbucks-mcp-cf": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:8787/sse"
      ]
    }
  }
}

You can run a remote MCP Server on Cloudflare Workers and connect to it from local MCP clients or the Cloudflare AI Playground. This setup lets you expose and use your tools over SSE without needing authentication, making it easy to test and integrate your tools in a remote environment.

How to use

Once your remote MCP Server is deployed, you can access and control it from multiple clients. Use the Cloudflare AI Playground to experiment with your MCP tools directly in a browser. You can also connect from local MCP clients through a proxy setup that communicates with your remote server over SSE.

How to install

Prerequisites: you need Node.js and npm installed on your machine. Node.js version 14 or newer is recommended.

Install and scaffold the remote MCP Server project locally with the following command. This creates a new MCP server configured for a Cloudflare-based remote setup.

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

After running the command, your MCP server will be available at a Cloudflare Workers URL similar to remote-mcp-server-authless.<your-account>.workers.dev/sse. You can also deploy and run a local version using the same template commands.

Configuration and usage notes

To customize your MCP server, add each tool inside the init() method of src/index.ts using this.server.tool(...). This is where you define the tools that your MCP server will expose to clients.

Connect to the Cloudflare AI Playground to try your MCP server with a remote client. Open the Playground, enter your deployed MCP server URL, and start using your tools directly from the playground interface.

You can also connect from Claude Desktop by using the mcp-remote proxy. In Claude Desktop, open Settings > Developer > Edit Config and add or update the mcpServers section to point to your remote server. The following example shows how to configure a calculator tool to connect to a remote SSE endpoint.

Example: Claude Desktop configuration

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