Remote MCP Server on Cloudflare

基本能力

产品定位

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

核心功能

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

适用场景

1. 开发者工具集成：与 MCP Inspector 或 Claude Desktop 集成，实现工具调用。
2. 云端部署：在 Cloudflare Workers 上部署 MCP 服务。
3. 本地调试：在本地开发环境中测试和调试 MCP 服务。

工具列表

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

常见问题解答

1. 调试问题：可以通过重启 Claude 或直接通过命令行连接 MCP 服务器进行调试。
2. 认证问题：清除 ~/.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. 配置 Transport Type 为 SSE，输入 http://localhost:8787/sse 作为 MCP 服务器 URL。
3. 登录后即可调用工具。

部署到 Cloudflare

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

远程连接

1. 使用 MCP Inspector 连接到 workers.dev URL。
2. 更新 Claude 配置文件以指向远程 URL。

许可证

None