Remote MCP Server on Cloudflare

Name: Remote MCP Server on Cloudflare
Author: jongan69

@jongan69

代码仓库

关于 Remote MCP Server on Cloudflare

暂无概览

#remote-mcp-server #cloudflare #mcp-inspector

基本信息

分类

云与基础设施

运行时

node

传输方式

stdio

发布者

jongan69

配置

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

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

工具

未检测到工具

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

概览

What is Remote MCP Server on Cloudflare?

This project provides a template to run a remote MCP (Model Context Protocol) server on Cloudflare Workers, complete with OAuth login for authentication. It is intended for developers who want to expose MCP tools over the internet with a secure login flow.

How to use Remote MCP Server on Cloudflare?

Clone the repository, install dependencies with npm install, and run locally with npx nx dev remote-mcp-server. Deploy to Cloudflare using npm run deploy after creating a KV namespace with npx wrangler kv namespace create OAUTH_KV and configuring it in wrangler.jsonc.

Key features of Remote MCP Server on Cloudflare

Runs on Cloudflare Workers with OAuth login.
Uses SSE (Server-Sent Events) transport for MCP.
Works with MCP Inspector for testing tools.
Connects to Claude Desktop via mcp-remote.
Simple deployment with npm run deploy.

Use cases of Remote MCP Server on Cloudflare

Hosting custom MCP tools accessible from any MCP client.
Providing a remote math tool that Claude Desktop can invoke.
Building and testing MCP servers locally before deploying globally.

FAQ from Remote MCP Server on Cloudflare

How do I run the MCP server locally?

Run npx nx dev remote-mcp-server from the project root, then open http://localhost:8787/ in your browser.

How do I test the server with MCP Inspector?

Start the inspector with npx @modelcontextprotocol/inspector, set Transport Type to SSE, enter http://localhost:8787/sse as the URL, and log in with any email/password.

How do I deploy the server to Cloudflare?

Create a KV namespace with npx wrangler kv namespace create OAUTH_KV, add the namespace ID to wrangler.jsonc, then run npm run deploy.

How do I connect Claude Desktop to the server?

Edit Claude Desktop's config file to add an MCP server entry using npx mcp-remote with the SSE URL (local or remote). Restart Claude and log in via the browser window.

What should I do if something goes wrong?

Restart Claude or test the server directly with npx mcp-remote http://localhost:8787/sse. If needed, clear the OAuth files in ~/.mcp-auth with rm -rf ~/.mcp-auth.