项目简介

本项目 'Cloudflare远程MCP服务器' 是一个基于 Model Context Protocol (MCP) 标准构建的后端服务，旨在云端 (Cloudflare Workers) 提供可远程访问的MCP服务器能力。它允许开发者快速部署一个支持OAuth登录验证的MCP服务器，并能方便地与支持MCP协议的客户端（如Claude、MCP Inspector等）进行集成，为大型语言模型应用提供上下文信息和工具扩展能力。

主要功能点

远程访问的MCP服务器: 基于 Cloudflare Workers 部署，实现云端 MCP 服务，方便远程客户端连接。
OAuth 登录验证: 集成 OAuth 登录机制，为 MCP 服务器提供基础的身份验证和授权能力，保障服务安全性。
工具注册与调用: 支持 MCP 协议定义的工具注册和调用，允许 LLM 客户端通过服务器发现和调用外部功能 (示例中提供了一个简单的 'add' 工具)。
SSE 传输协议: 默认使用 Server-Sent Events (SSE) 作为 MCP 通信协议，支持客户端与服务器进行实时数据交换。
集成 MCP Inspector: 提供详细的步骤，指导用户如何使用 MCP Inspector 工具连接和测试该服务器。
集成 Claude Desktop: 提供配置示例，指导用户如何将 Claude Desktop 连接到该 MCP 服务器，扩展 Claude 的功能。
易于部署: 提供 Cloudflare Workers 部署脚本和详细步骤，简化部署流程。

安装步骤

克隆仓库:

git clone https://github.com/swyxio/pls-ignore-remote-mcp-server
cd pls-ignore-remote-mcp-server

安装依赖:
```
npm install
```

本地开发运行:

npx nx dev remote-mcp-server

服务器将在 'http://localhost:8787/' 启动。

部署到 Cloudflare Workers:
- 确保已安装 'wrangler' CLI 工具并已登录 Cloudflare 账号。
- 创建 KV 命名空间用于 OAuth (按照仓库 README 指引操作):
```
npx wrangler kv namespace create OAUTH_KV
```
- 将 KV 命名空间 ID 添加到 'wrangler.jsonc' 配置文件。
- 执行部署命令:
```
npm run deploy
```
- 部署成功后，会得到一个 'workers.dev' 域名 URL，例如 'worker-name.account-name.workers.dev'。

服务器配置

要让 MCP 客户端（例如 Claude Desktop）连接到此 MCP 服务器，您需要配置客户端的 MCP 服务器设置。以下是 Claude Desktop 的配置示例，您需要修改 'args' 中的 URL 为您的服务器地址。

{
  "mcpServers": {
    "math": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:8787/sse"
        //  如果部署到 Cloudflare Workers，请将以上地址替换为您的 workers.dev URL
        //  例如: "https://worker-name.account-name.workers.dev/sse"
      ]
      //  "command": "npx mcp-remote"  -  指定用于启动 MCP 客户端代理的命令，通常是 'mcp-remote'。
      //  "args": [...]  -  传递给 'mcp-remote' 命令的参数列表。
      //     - 第一个参数 "mcp-remote" 是命令本身。
      //     - 第二个参数 "http://localhost:8787/sse"  是 MCP 服务器的 SSE 端点 URL，需要根据实际部署地址修改。
      //     - 注意：Claude Desktop 通过本地代理 'mcp-remote' 与远程 MCP 服务器通信。
    }
  }
}

基本使用方法

使用 MCP Inspector 连接:
- 启动 MCP Inspector: 'npx @modelcontextprotocol/inspector@latest'
- 在 Inspector 中，将 Transport Type 设置为 'SSE'，URL 设置为您的服务器 SSE 端点 (例如 'http://localhost:8787/sse' 或 'https://worker-name.account-name.workers.dev/sse')，点击 "Connect"。
- 按照页面提示进行 (mock) 登录 (输入任意邮箱和密码即可)。
- 连接成功后，您可以在 Inspector 中查看和调用服务器注册的工具。
配置 Claude Desktop 连接:
- 按照上述“服务器配置”部分修改 Claude Desktop 的配置文件 ('config.json')。
- 重启 Claude Desktop。
- 当 Claude 启动时，应该会打开浏览器窗口进行登录 (mock 登录)。
- 登录成功后，您可以在 Claude Desktop 的工具列表中看到服务器提供的工具。在对话中，根据提示词，Claude 应该能够调用这些工具。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息