Remote MCP Server on Cloudflare

Remote MCP Server on Cloudflare

site icon
2025.04.20 0
TypeScript远程 MCP 服务器工具调用开发效率
kd-mcp-server 是一个基于 Cloudflare Workers 的远程 MCP 服务器,支持 OAuth 登录。它允许开发者通过 MCP Inspector 或 Claude Desktop 连接并调用定义的 MCP 工具。该服务器适合用于开发和调试 MCP 工具,以及集成到 Claude 等 AI 工具中。
View on GitHub

Overview

基本能力

产品定位

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

核心功能

  • 在 Cloudflare Workers 上运行远程 MCP 服务器
  • 支持 OAuth 登录
  • 提供 MCP Inspector 连接功能
  • 支持 Claude Desktop 集成
  • 提供本地和远程调试能力

适用场景

  • 开发和调试 MCP 工具
  • 集成 MCP 工具到 Claude 等 AI 工具中
  • 远程调用 MCP 服务

工具列表

  • MCP Inspector: 用于探索和调用 MCP API 的工具,支持 SSE 传输类型。
  • mcp-remote: 用于在命令行中连接 MCP 服务器的工具。

常见问题解答

  • 如果连接出现问题,可以尝试重启 Claude 或直接通过命令行连接 MCP 服务器。
  • 在某些情况下,清除 ~/.mcp-auth 目录中的文件可能有助于解决问题。

使用教程

使用依赖

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

安装教程

  1. 本地运行 MCP 服务器:
npx nx dev remote-mcp-server
  1. 打开浏览器访问 http://localhost:8787/

调试方式

  1. 使用 MCP Inspector 连接服务器:
npx @modelcontextprotocol/inspector
  1. 在 Inspector 中配置 SSE 传输类型和服务器 URL(如 http://localhost:8787/sse)。
  2. 通过命令行直接连接服务器:
npx mcp-remote http://localhost:8787/sse
  1. 清除认证文件:
rm -rf ~/.mcp-auth

许可证

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