Remote MCP Server on Cloudflare

基本能力

产品定位

remote-mcp-server 是一个远程 MCP 服务器，旨在为开发者提供一个基于 Cloudflare Workers 的 MCP 工具调用平台，支持 OAuth 登录和远程连接。

核心功能

1. 远程 MCP 服务器：支持在 Cloudflare Workers 上部署和运行 MCP 服务器。
2. OAuth 登录：提供用户认证功能，支持通过 OAuth 登录访问 MCP 工具。
3. 工具调用：允许通过 MCP Inspector 或 Claude Desktop 调用定义的 MCP 工具。
4. 本地开发和云部署：支持本地开发环境和云部署两种方式。

适用场景

1. 远程工具调用：适用于需要通过远程服务器调用 MCP 工具的场景。
2. 开发测试：开发者可以在本地环境中测试 MCP 工具的功能。
3. 云部署：适用于需要在云环境中部署和运行 MCP 服务器的场景。

工具列表

1. MCP Inspector：用于探索和调用 MCP API 的工具。
2. Claude Desktop：通过配置文件连接到 MCP 服务器，调用 MCP 工具。

常见问题解答

1. 调试问题：如果连接失败，可以尝试重启 Claude 或清除 ~/.mcp-auth 目录中的文件。
2. 部署问题：部署到 Cloudflare 时需要配置 KV 命名空间并更新 wrangler.jsonc 文件。

使用教程

使用依赖

1. 克隆仓库： bash git clone [email protected]:cloudflare/ai.git
2. 安装依赖： bash cd ai npm install

安装教程

1. 运行本地开发服务器： bash npx nx dev remote-mcp-server
2. 打开浏览器访问 http://localhost:8787/。

调试方式

1. 使用 MCP Inspector 连接： bash npx @modelcontextprotocol/inspector
2. 配置 MCP Inspector 使用 SSE 传输类型，URL 为 http://localhost:8787/sse。
3. 登录后即可调用工具。

部署到 Cloudflare

1. 创建 KV 命名空间： bash npx wrangler kv namespace create OAUTH_KV
2. 更新 wrangler.jsonc 文件中的 KV 命名空间 ID。
3. 部署： bash npm run deploy

许可证

None