Remote MCP Server on Cloudflare

Remote MCP Server on Cloudflare

site icon
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 服务器。

使用教程

使用依赖

  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 中设置 Transport Type 为 SSE,URL 为 http://localhost:8787/sse
  3. 登录后即可调用工具。

部署到 Cloudflare

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

远程连接

  1. 使用 MCP Inspector 连接远程服务器: bash npx @modelcontextprotocol/inspector@latest
  2. 输入 workers.dev URL 并连接。

连接 Claude Desktop

  1. 更新 Claude 配置文件,指向远程服务器 URL。
  2. 重启 Claude。

许可证

None