Remote MCP Server on Cloudflare

Name: Remote MCP Server on Cloudflare
Author: MCP-Mirror

@MCP-Mirror

代码仓库

关于 Remote MCP Server on Cloudflare

Mirror of

基本信息

分类

开发工具

运行时

node

传输方式

stdio

发布者

MCP-Mirror

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "huanshenyi_mcp-server-bearer-auth": {
      "command": "npx",
      "args": [
        "nx",
        "dev",
        "remote-mcp-server-bearer-auth"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is Remote MCP Server on Cloudflare?

A template for deploying a remote MCP (Model Context Protocol) server on Cloudflare Workers with OAuth login. It provides a ready-to-run MCP server using SSE transport, intended for developers who want to run MCP servers remotely.

How to use Remote MCP Server on Cloudflare?

Clone the repository, install dependencies with npm install, run locally with npx nx dev remote-mcp-server-bearer-auth, then connect using the MCP Inspector or a remote MCP client. Deploy to Cloudflare with npm run deploy. Connect a remote client by pointing it to the workers.dev URL appended with /sse.

Key features of Remote MCP Server on Cloudflare

Deploys to Cloudflare Workers for remote access.
Includes OAuth login out of the box.
Supports local development with npx nx dev.
Integrates with the MCP Inspector for testing.
Uses SSE (Server-Sent Events) transport.
Provides a getToken tool to inspect the Authorization header.

Use cases of Remote MCP Server on Cloudflare

Running a remote MCP server that can be accessed from any client.
Testing MCP tool calls locally with the MCP Inspector.
Connecting Claude Desktop to a remote MCP server via the mcp-remote proxy.
Demonstrating how to secure an MCP server with bearer token authentication.

FAQ from Remote MCP Server on Cloudflare

How do I deploy the server?

Run npm run deploy from the project directory. The server will be published to your Cloudflare Workers account.

How do I test the server locally?

After starting the local dev server, open the MCP Inspector (npx @modelcontextprotocol/inspector), switch transport type to SSE, enter http://localhost:8787/sse as the URL, add a bearer token, and click Connect. Then list tools and run getToken.

How do I connect a remote client?

Use the MCP Inspector or any MCP client that supports SSE. Provide the full Workers URL (e.g., worker-name.account-name.workers.dev/sse) and optionally a bearer token.

How do I connect Claude Desktop?

Add an entry to your Claude Desktop configuration using the mcp-remote command with the SSE URL and the Authorization header. Example:

{
  "command": "npx",
  "args": ["mcp-remote", "http://localhost:8787/sse", "--header", "Authorization: Bearer {token}"]
}

What should I do if something goes wrong?

Restart Claude, try connecting directly via the command line (npx mcp-remote http://localhost:8787/sse), or clear cached authentication files with rm -rf ~/.mcp-auth.