Remote MCP Server on Cloudflare

Remote MCP Server on Cloudflare

site icon
2025.03.31 0
TypeScript远程服务工具集成开发效率
my-mcp-server 是一个基于 Cloudflare Workers 的远程 MCP 服务器,支持 OAuth 登录。它允许开发者通过 MCP 协议与 Claude 等工具进行交互,提供工具调用和远程服务连接的能力。
View on GitHub

Overview

基本能力

产品定位

my-mcp-server 是一个远程 MCP 服务器,旨在为开发者提供工具调用和远程服务连接的能力,支持与 Claude 等工具的无缝集成。

核心功能

  1. 远程 MCP 服务:在 Cloudflare Workers 上运行,支持 OAuth 登录。
  2. 工具调用:通过 MCP 协议调用定义的工具。
  3. 本地开发支持:提供本地开发和调试的能力。
  4. 远程部署:支持部署到 Cloudflare Workers,实现远程访问。

适用场景

  1. 开发调试:开发者可以在本地运行和调试 MCP 服务。
  2. 工具集成:与 Claude 等工具集成,扩展其功能。
  3. 远程服务:部署到 Cloudflare Workers,提供远程 MCP 服务。

工具列表

  1. MCP Inspector:用于探索和调用 MCP API 的工具。
  2. 能力:连接 MCP 服务器,列出和调用定义的工具。
  3. Claude Desktop:通过 MCP 协议与 MCP 服务器交互的工具。
  4. 能力:调用远程 MCP 服务器提供的工具。

常见问题解答

  1. 连接问题:如果连接失败,可以尝试重启 Claude 或清除 ~/.mcp-auth 文件。
  2. 调试工具:可以使用 npx mcp-remote 命令直接连接 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 并连接。

调试命令

  1. 直接连接 MCP 服务器: bash npx mcp-remote http://localhost:8787/sse
  2. 清除认证文件: bash rm -rf ~/.mcp-auth

许可证

None