Remote MCP Server on Cloudflare

Remote MCP Server on Cloudflare

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

Overview

基本能力

产品定位

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

核心功能

  • 支持在Cloudflare Workers上部署MCP服务器
  • 提供OAuth登录功能
  • 支持通过MCP Inspector和Claude Desktop等工具进行交互
  • 允许调用定义的工具

适用场景

  • 开发者在本地或云端部署MCP服务
  • 通过MCP Inspector进行工具调用和调试
  • 通过Claude Desktop与MCP服务器进行交互

工具列表

  • MCP Inspector: 用于探索和调用MCP API的工具,支持SSE传输类型。
  • Claude Desktop: 通过配置文件中指定MCP服务器地址,与MCP服务器进行交互。

常见问题解答

  • 如果遇到问题,可以尝试重启Claude或直接通过命令行连接MCP服务器。
  • 在某些情况下,清除~/.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,输入MCP服务器URL(如http://localhost:8787/sse),点击“连接”。
  3. 登录后即可调用定义的工具。

部署到Cloudflare

  1. 创建KV命名空间: bash npx wrangler kv namespace create OAUTH_KV
  2. 将KV命名空间ID添加到wrangler.jsonc
  3. 部署: bash npm run deploy

调试命令

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

许可证

None