项目简介

Remote MCP Server (Cloudflare) 是一个在Cloudflare Workers上运行的Model Context Protocol (MCP) 服务器实现。它旨在帮助开发者快速部署和管理MCP服务，为LLM应用提供上下文信息和工具调用能力。该项目利用Cloudflare Workers的serverless特性，具备高可用性和弹性伸缩能力。同时，集成了OAuth登录认证，确保了服务的安全性。

主要功能点

资源管理: 虽然仓库代码中未显式展示资源管理功能，但MCP服务器的核心职责包含资源管理，理论上具备扩展资源管理能力。
工具注册与执行: 实现了工具 (Tools) 的注册和执行，示例中提供了一个简单的 'add' 工具。
Prompt 模板: 仓库未直接体现 Prompt 模板功能，但作为MCP服务器，具备支持 Prompt 模板的潜力，可以根据需要进行扩展。
JSON-RPC over SSE: 使用JSON-RPC协议通过 Server-Sent Events (SSE) 与客户端通信。
OAuth 认证: 集成了OAuth登录认证，保护服务器接口安全。
Cloudflare Workers 部署: 设计为在 Cloudflare Workers 上运行，易于部署和扩展。

安装步骤

克隆仓库:

git clone https://github.com/steveafrost/remote-mcp-server.git
cd remote-mcp-server

安装依赖:
```
npm install
```
部署到 Cloudflare Workers:
- 确保已安装 Wrangler CLI.
- 创建 Cloudflare KV 命名空间用于 OAuth：
```
npx wrangler kv namespace create OAUTH_KV
```
- 将创建的 KV 命名空间 ID 添加到 'wrangler.jsonc' 配置文件中。
- 部署 Worker：
```
npm run deploy
```
- 部署成功后，您将获得一个 'workers.dev' 子域名 URL，例如 'your-worker-name.account-name.workers.dev'。

服务器配置

要将 MCP 客户端（如 Claude Desktop 或 MCP Inspector）连接到此服务器，您需要配置客户端的 MCP 服务器设置。以下是 Claude Desktop 的配置示例，您需要将 'http://localhost:8787/sse' 或 'https://worker-name.account-name.workers.dev/sse' 替换为您的 MCP 服务器地址。

{
  "mcpServers": {
    "remote-mcp-server": {  // 服务器名称，可以自定义
      "command": "npx",    // 启动命令，这里使用 npx
      "args": [           // 命令参数
        "mcp-remote",     // 使用 mcp-remote 客户端代理
        "https://worker-name.account-name.workers.dev/sse" // 您的 Remote MCP Server SSE 地址，部署后获取
      ]
    }
  }
}

参数注释:

'server name': MCP 服务器的自定义名称，用于在客户端中标识和选择。
'command': 启动 MCP 服务器的命令，通常使用 'npx' 来执行 npm 包。
'args': 传递给启动命令的参数列表。
- '"mcp-remote"': 使用 'mcp-remote' 客户端代理，这是一个常用的 MCP 客户端工具，用于连接远程 MCP 服务器。
- '"https://worker-name.account-name.workers.dev/sse"': 重要 - 替换为您部署后获得的 Remote MCP Server 的 SSE 端点 URL。这是 MCP 客户端连接服务器的关键地址。

基本使用方法

本地开发: 按照 README.md 中的 "Develop locally" 部分操作，启动本地服务器。
连接 MCP Inspector: 按照 README.md 中的 "Connect the MCP inspector to your server" 部分操作，使用 MCP Inspector 连接到本地或远程服务器，测试工具调用。
连接 Claude Desktop: 按照 README.md 中的 "Connect Claude Desktop to your local MCP server" 或 "Connect Claude Desktop to your remote MCP server" 部分操作，配置 Claude Desktop 连接到本地或远程服务器，体验在 Claude 中调用工具。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息