Remote MCP Server on Cloudflare

Remote MCP Server on Cloudflare

site icon
2025.04.01 0
TypeScript远程MCP服务Cloudflare Workers其它
Remote MCP Server是一个基于Cloudflare Workers的远程MCP服务器,支持OAuth登录。它允许开发者通过MCP Inspector或Claude Desktop等工具与MCP服务器进行交互,调用定义的工具。该服务器适用于开发者在本地或云端部署和调试MCP服务。
View on GitHub

Overview

基本能力

产品定位

Remote MCP Server是一个基于Cloudflare Workers的远程MCP服务器,支持OAuth登录,旨在为开发者提供一个便捷的MCP服务部署和调试环境。

核心功能

  1. 支持OAuth登录
  2. 提供本地和云端部署选项
  3. 支持通过MCP Inspector和Claude Desktop等工具进行交互
  4. 允许调用定义的MCP工具

适用场景

  1. 开发者在本地调试MCP服务
  2. 在Cloudflare Workers上部署远程MCP服务
  3. 通过Claude Desktop等客户端与MCP服务交互

工具列表

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

常见问题解答

  1. 如何调试连接问题?
  2. 重启Claude或尝试使用命令行工具npx mcp-remote直接连接。
  3. 清除~/.mcp-auth目录下的文件。

使用教程

使用依赖

  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传输类型,输入http://localhost:8787/sse作为MCP服务器URL。
  3. 使用命令行工具调试: bash npx mcp-remote http://localhost:8787/sse
  4. 清除认证文件: bash rm -rf ~/.mcp-auth

部署到Cloudflare

  1. 创建KV命名空间: bash npx wrangler kv namespace create OAUTH_KV
  2. 更新wrangler.jsonc文件,添加KV命名空间ID。
  3. 部署: bash npm run deploy

远程连接

  1. 使用MCP Inspector连接远程服务器: bash npx @modelcontextprotocol/inspector@latest
  2. 输入workers.dev URL作为MCP服务器URL。
  3. 更新Claude配置,指向远程服务器URL。

许可证

None