
Remote MCP Server on Cloudflare

2025.03.27
0
TypeScript远程 MCP 服务器工具调用开发效率
cf-remote-mcp-server 是一个基于 Cloudflare Workers 的远程 MCP 服务器,支持 OAuth 登录。它允许开发者通过 MCP Inspector 或 Claude Desktop 等工具与 MCP 服务器进行交互,调用定义的工具。
View on GitHub
Overview
基本能力
产品定位
cf-remote-mcp-server 是一个远程 MCP 服务器,旨在为开发者提供一个在 Cloudflare Workers 上运行的 MCP 服务,支持 OAuth 登录和工具调用。
核心功能
- 支持在 Cloudflare Workers 上部署远程 MCP 服务器。
- 提供 OAuth 登录功能。
- 允许通过 MCP Inspector 或 Claude Desktop 等工具与 MCP 服务器交互。
- 支持工具调用和调试。
适用场景
- 开发者需要在 Cloudflare Workers 上运行 MCP 服务器。
- 需要通过 OAuth 登录进行身份验证的场景。
- 使用 MCP Inspector 或 Claude Desktop 进行工具调用和调试。
工具列表
- MCP Inspector:用于探索和调用 MCP API 的工具。
- Claude Desktop:通过配置连接到 MCP 服务器,调用工具。
常见问题解答
- 连接问题:如果连接失败,可以尝试重启 Claude 或清除
~/.mcp-auth
目录。 - 调试:可以通过命令行直接连接到 MCP 服务器进行调试。
使用教程
使用依赖
- 安装 Node.js 和 npm。
- 克隆仓库并安装依赖:
git clone [email protected]:cloudflare/ai.git
cd ai
npm install
安装教程
- 运行本地开发服务器:
npx nx dev remote-mcp-server
- 打开
http://localhost:8787/
进行测试。
调试方式
- 使用 MCP Inspector 进行调试:
npx @modelcontextprotocol/inspector
- 配置 MCP Inspector 连接到
http://localhost:8787/sse
。 - 使用命令行调试:
npx mcp-remote http://localhost:8787/sse
- 清除认证文件:
rm -rf ~/.mcp-auth
部署到 Cloudflare
- 创建 KV 命名空间:
npx wrangler kv namespace create OAUTH_KV
- 更新
wrangler.jsonc
文件。 - 部署:
npm run deploy
许可证
None