Remote MCP Server on Cloudflare

基本能力

产品定位

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

核心功能

• 在 Cloudflare Workers 上运行远程 MCP 服务器
• 支持 OAuth 登录
• 提供本地开发和调试支持
• 支持通过 MCP Inspector 和 Claude Desktop 连接
• 支持部署到 Cloudflare

适用场景

• 开发和调试 MCP 工具
• 集成 MCP 工具到 Claude 等 AI 应用中
• 远程调用 MCP 工具

工具列表

• MCP Inspector: 用于探索和调用 MCP API 的工具，支持 SSE 传输类型。
• Claude Desktop: 通过配置文件连接到 MCP 服务器，调用 MCP 工具。

常见问题解答

• 如果连接出现问题，可以尝试重启 Claude 或直接通过命令行连接到 MCP 服务器。
• 在某些情况下，清除 ~/.mcp-auth 目录中的文件可能有助于解决问题。

使用教程

使用依赖

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. 在 Inspector 中设置传输类型为 SSE，并输入 MCP 服务器的 URL（如 http://localhost:8787/sse）。
3. 登录后即可调用工具。

部署到 Cloudflare

1. 创建 KV 命名空间： bash npx wrangler kv namespace create OAUTH_KV
2. 将 KV 命名空间 ID 添加到 wrangler.jsonc。
3. 部署： bash npm run deploy

调试命令

1. 直接连接到 MCP 服务器： bash npx mcp-remote http://localhost:8787/sse
2. 清除认证文件： bash rm -rf ~/.mcp-auth

许可证

None