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 工具。该服务适用于开发者在本地或云端部署 MCP 服务器,并通过客户端工具进行交互和调试。
View on GitHub

Overview

基本能力

产品定位

Remote MCP Server on Cloudflare 是一个远程 MCP 服务器,旨在为开发者提供在 Cloudflare Workers 上部署和运行 MCP 服务的能力,支持 OAuth 登录和工具调用。

核心功能

  1. 支持在 Cloudflare Workers 上部署 MCP 服务器。
  2. 提供本地开发环境,支持快速启动和调试。
  3. 支持通过 MCP Inspector 和 Claude Desktop 连接并调用 MCP 工具。
  4. 提供 OAuth 登录功能,支持用户认证。
  5. 支持通过命令行工具进行远程连接和调试。

适用场景

  1. 开发者在本地或云端部署 MCP 服务器。
  2. 通过 MCP Inspector 或 Claude Desktop 调用 MCP 工具。
  3. 需要 OAuth 登录的 MCP 服务场景。

工具列表

  1. MCP Inspector:用于探索和调用 MCP API 的工具,支持 SSE 传输类型。
  2. Claude Desktop:通过配置文件连接 MCP 服务器,调用可用工具。
  3. mcp-remote:命令行工具,用于直接连接 MCP 服务器进行调试。

常见问题解答

  1. 连接失败:尝试重启 Claude 或清除 ~/.mcp-auth 目录下的文件。
  2. 调试问题:使用 npx mcp-remote 命令直接连接服务器进行调试。

使用教程

使用依赖

  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 中配置 SSE 传输类型和服务器 URL(如 http://localhost:8787/sse)。
  3. 使用命令行调试: bash npx mcp-remote http://localhost:8787/sse
  4. 清除认证文件: bash rm -rf ~/.mcp-auth

许可证

None