Remote MCP Server on Cloudflare

Remote MCP Server on Cloudflare

site icon
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 登录和工具调用。

核心功能

  1. 支持在 Cloudflare Workers 上部署远程 MCP 服务器。
  2. 提供 OAuth 登录功能。
  3. 允许通过 MCP Inspector 或 Claude Desktop 等工具与 MCP 服务器交互。
  4. 支持工具调用和调试。

适用场景

  1. 开发者需要在 Cloudflare Workers 上运行 MCP 服务器。
  2. 需要通过 OAuth 登录进行身份验证的场景。
  3. 使用 MCP Inspector 或 Claude Desktop 进行工具调用和调试。

工具列表

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

常见问题解答

  1. 连接问题:如果连接失败,可以尝试重启 Claude 或清除 ~/.mcp-auth 目录。
  2. 调试:可以通过命令行直接连接到 MCP 服务器进行调试。

使用教程

使用依赖

  1. 安装 Node.js 和 npm。
  2. 克隆仓库并安装依赖:
git clone [email protected]:cloudflare/ai.git
cd ai
npm install

安装教程

  1. 运行本地开发服务器:
npx nx dev remote-mcp-server
  1. 打开 http://localhost:8787/ 进行测试。

调试方式

  1. 使用 MCP Inspector 进行调试:
npx @modelcontextprotocol/inspector
  1. 配置 MCP Inspector 连接到 http://localhost:8787/sse
  2. 使用命令行调试:
npx mcp-remote http://localhost:8787/sse
  1. 清除认证文件:
rm -rf ~/.mcp-auth

部署到 Cloudflare

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

许可证

None