
Remote MCP Server on Cloudflare

2025.03.26
0
TypeScript远程 MCP 服务器OAuth 登录工具调用开发效率
Remote MCP Server on Cloudflare 是一个基于 Cloudflare Workers 的远程 MCP 服务器,支持 OAuth 登录。它允许开发者通过 MCP Inspector 或 Claude Desktop 等工具与 MCP API 进行交互,调用定义的工具。
View on GitHub
Overview
基本能力
产品定位
Remote MCP Server on Cloudflare 是一个远程 MCP 服务器,旨在为开发者提供一种简单的方式来部署和运行 MCP API,支持 OAuth 登录和工具调用。
核心功能
- 支持在 Cloudflare Workers 上部署远程 MCP 服务器。
- 提供 OAuth 登录功能。
- 允许通过 MCP Inspector 或 Claude Desktop 等工具与 MCP API 交互。
- 支持本地开发和远程部署。
适用场景
- 开发者需要在 Cloudflare Workers 上快速部署 MCP 服务器。
- 需要通过 OAuth 登录保护 MCP API。
- 需要与 Claude Desktop 或其他 MCP 客户端集成。
工具列表
- MCP Inspector: 用于探索和调用 MCP API 的工具。
- Claude Desktop: 通过配置与 MCP 服务器交互的客户端。
常见问题解答
- 如果连接失败,可以尝试重启 Claude 或清除
~/.mcp-auth
目录。 - 调试时可以使用
npx mcp-remote http://localhost:8787/sse
命令直接连接 MCP 服务器。
使用教程
使用依赖
- 克隆仓库:
bash git clone [email protected]:cloudflare/ai.git
- 安装依赖:
bash cd ai npm install
安装教程
- 本地运行:
bash npx nx dev remote-mcp-server
- 打开浏览器访问
http://localhost:8787/
。
调试方式
- 使用 MCP Inspector 连接:
bash npx @modelcontextprotocol/inspector
- 在 Inspector 中设置 Transport Type 为
SSE
,URL 为http://localhost:8787/sse
。 - 登录后即可调用工具。
部署到 Cloudflare
- 创建 KV 命名空间:
bash npx wrangler kv namespace create OAUTH_KV
- 更新
wrangler.jsonc
文件。 - 部署:
bash npm run deploy
远程连接
- 使用 MCP Inspector 连接远程服务器:
bash npx @modelcontextprotocol/inspector@latest
- 输入
workers.dev
URL 并连接。
连接 Claude Desktop
- 更新 Claude 配置文件,指向远程服务器 URL。
- 重启 Claude。
许可证
None