Remote MCP Server on Cloudflare

Remote MCP Server on Cloudflare

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

Overview

基本能力

产品定位

remote-mcp-server-demo 是一个远程 MCP 服务器,旨在为开发者提供一个可通过 MCP 协议进行交互的服务端环境。

核心功能

  1. 支持 OAuth 登录
  2. 提供 MCP 协议的 SSE 传输类型
  3. 可通过 MCP Inspector 或 Claude Desktop 进行交互
  4. 支持本地开发和云端部署

适用场景

  1. 开发者在本地调试 MCP 工具
  2. 在云端部署 MCP 服务器供远程客户端调用
  3. 与 Claude Desktop 集成,扩展其功能

工具列表

  1. MCP Inspector:用于探索和调用 MCP API 的工具。
  2. Claude Desktop:通过配置与 MCP 服务器集成,扩展其功能。
  3. mcp-remote:命令行工具,用于直接与 MCP 服务器交互。

常见问题解答

  1. 调试问题:可以尝试重启 Claude 或直接通过命令行连接 MCP 服务器。
  2. 认证问题:清除 ~/.mcp-auth 目录下的文件可能有助于解决认证问题。

使用教程

使用依赖

  1. 安装 Node.js 和 npm
  2. 安装 Git

安装教程

# 克隆仓库
git clone [email protected]:cloudflare/ai.git

# 安装依赖
cd ai
npm install

# 本地运行
npx nx dev remote-mcp-server

调试方式

  1. 使用 MCP Inspector 连接服务器:
npx @modelcontextprotocol/inspector
  1. 通过命令行直接连接 MCP 服务器:
npx mcp-remote http://localhost:8787/sse
  1. 清除认证文件:
rm -rf ~/.mcp-auth

许可证

None