Remote MCP Server on Cloudflare

Remote MCP Server on Cloudflare

site icon
2025.03.22 0
TypeScript远程服务工具调用开发效率
remote-mcp-server-2 是一个基于 Cloudflare Workers 的远程 MCP 服务器,支持 OAuth 登录。它允许开发者通过 MCP Inspector 或 Claude Desktop 等工具连接到服务器,调用定义的 MCP 工具。该服务器适用于开发者在本地或云端部署 MCP 服务,并通过客户端工具进行交互和调试。
View on GitHub

Overview

基本能力

产品定位

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

核心功能

  1. 远程 MCP 服务:在 Cloudflare Workers 上部署 MCP 服务器。
  2. OAuth 登录:支持用户通过 OAuth 登录验证。
  3. 工具调用:允许客户端(如 MCP Inspector 或 Claude Desktop)调用服务器上定义的 MCP 工具。
  4. 本地开发支持:提供本地开发环境,方便开发者测试和调试。

适用场景

  1. 开发测试:开发者在本地或云端测试 MCP 工具和服务。
  2. 工具集成:将 MCP 服务集成到 Claude Desktop 等客户端工具中。
  3. 远程部署:在 Cloudflare Workers 上部署 MCP 服务,供远程客户端访问。

工具列表

  1. MCP Inspector:用于探索和调用 MCP API 的工具。
  2. 能力:连接到 MCP 服务器,列出和调用定义的 MCP 工具。
  3. Claude Desktop:支持通过配置文件连接到 MCP 服务器的客户端工具。
  4. 能力:调用 MCP 服务器上的工具,如数学计算等。

常见问题解答

  1. 连接问题:如果连接失败,可以尝试重启 Claude 或清除 ~/.mcp-auth 目录下的文件。
  2. 调试命令:使用 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. 在 MCP Inspector 中配置 Transport Type 为 SSE,URL 为 http://localhost:8787/sse
  3. 使用调试命令直接连接: bash npx mcp-remote http://localhost:8787/sse
  4. 清除认证文件: bash rm -rf ~/.mcp-auth

许可证

该项目遵循 None 开源许可条款。