使用说明：

项目简介

本仓库提供了一个基于Cloudflare Workers构建的远程MCP服务器的演示示例。它展示了如何利用Model Context Protocol (MCP) 协议和Cloudflare Workers 搭建一个具备资源管理、工具注册和OAuth认证的后端服务，用于为LLM应用提供上下文支持。

主要功能点

MCP协议实现: 实现了基本的MCP服务器功能，能够处理来自MCP客户端的请求和响应。
工具注册与执行: 示例中注册了一个简单的 "add" 工具，演示了工具的定义和执行。
资源管理: 虽然示例较为基础，但项目结构支持扩展以实现资源的管理和访问控制。
OAuth认证: 集成了OAuth Provider，为MCP服务器提供用户认证和授权功能，保障安全性。
SSE传输协议: 使用Server-Sent Events (SSE) 作为与MCP客户端通信的传输协议。
Cloudflare Workers部署: 方便快捷地部署在Cloudflare Workers 平台，实现远程访问。

安装步骤

克隆仓库: 在本地克隆代码仓库：

git clone https://github.com/elithrar/remote-mcp-server-demo

cd remote-mcp-server-demo

安装依赖: 安装项目依赖：
```
npm install
```
部署到Cloudflare Workers: 参考仓库 'README.md' 文件中 "Deploy to Cloudflare" 部分的指引，完成在Cloudflare Workers 上的部署。需要配置 Wrangler 和 KV namespace。

服务器配置 (MCP客户端)

要将MCP客户端（例如 Claude Desktop 或 MCP Inspector）连接到此服务器，您需要在客户端中配置MCP服务器的连接信息。以下是一个配置示例，请根据您的实际部署情况进行修改：

{
  "server name": "remote-mcp-server-demo",
  "command": "npx",
  "args": [
    "mcp-remote",
    "YOUR_WORKERS_DEV_URL/sse"  // 请替换为您的 Cloudflare Worker 部署 URL
  ]
}

'server name': 您可以为该MCP服务器配置自定义的名称，方便在客户端中识别。
'command': 固定为 'npx'，用于执行 Node.js 包。
'args': 包含 'mcp-remote' 命令及其参数的数组：
- '"mcp-remote"': MCP远程客户端代理命令。
- '"YOUR_WORKERS_DEV_URL/sse"': 重要: 请将 'YOUR_WORKERS_DEV_URL' 替换为您部署的 Cloudflare Worker 的实际 URL，例如 'your-worker-name.account-name.workers.dev/sse'。此URL指向服务器的SSE端点。

基本使用方法

部署服务器: 首先按照安装步骤将MCP服务器部署到Cloudflare Workers。
配置MCP客户端: 在您的MCP客户端（如 Claude Desktop）中，根据上述“服务器配置”部分填写正确的服务器连接信息，务必替换为您自己的 Cloudflare Worker URL。
连接客户端: 启动您的MCP客户端，客户端会尝试连接到您配置的MCP服务器。您可能需要进行登录认证（本示例中可以使用任意邮箱和密码）。
使用工具: 连接成功后，您可以在MCP客户端中使用服务器提供的工具。本示例中包含一个名为 "add" 的简单加法工具，您可以通过客户端调用该工具进行数学运算。

关键词

信息