
Remote MCP Server on Cloudflare

2025.03.22
0
TypeScript远程服务工具调用开发效率
remote-mcp-server-2 是一个基于 Cloudflare Workers 的远程 MCP 服务器,支持 OAuth 登录。它允许开发者通过 MCP Inspector 或 Claude Desktop 等工具连接到服务器,调用定义的 MCP 工具。该服务器适用于开发者在本地或云端部署 MCP 服务,并通过客户端工具进行交互和调试。
View on GitHub
Overview
基本能力
产品定位
remote-mcp-server-2 是一个远程 MCP 服务器,旨在为开发者提供在 Cloudflare Workers 上部署和运行 MCP 服务的能力,支持 OAuth 登录和工具调用。
核心功能
- 远程 MCP 服务:在 Cloudflare Workers 上部署 MCP 服务器。
- OAuth 登录:支持用户通过 OAuth 登录验证。
- 工具调用:允许客户端(如 MCP Inspector 或 Claude Desktop)调用服务器上定义的 MCP 工具。
- 本地开发支持:提供本地开发环境,方便开发者测试和调试。
适用场景
- 开发测试:开发者在本地或云端测试 MCP 工具和服务。
- 工具集成:将 MCP 服务集成到 Claude Desktop 等客户端工具中。
- 远程部署:在 Cloudflare Workers 上部署 MCP 服务,供远程客户端访问。
工具列表
- MCP Inspector:用于探索和调用 MCP API 的工具。
- 能力:连接到 MCP 服务器,列出和调用定义的 MCP 工具。
- Claude Desktop:支持通过配置文件连接到 MCP 服务器的客户端工具。
- 能力:调用 MCP 服务器上的工具,如数学计算等。
常见问题解答
- 连接问题:如果连接失败,可以尝试重启 Claude 或清除
~/.mcp-auth
目录下的文件。 - 调试命令:使用
npx mcp-remote http://localhost:8787/sse
直接连接到 MCP 服务器进行调试。
使用教程
使用依赖
- 克隆仓库:
bash git clone [email protected]:cloudflare/ai.git
- 安装依赖:
bash cd ai npm install
安装教程
- 本地运行:
bash npx nx dev remote-mcp-server
- 访问
http://localhost:8787/
查看服务是否正常运行。
调试方式
- 使用 MCP Inspector 连接到服务器:
bash npx @modelcontextprotocol/inspector
- 在 MCP Inspector 中配置 Transport Type 为
SSE
,URL 为http://localhost:8787/sse
。 - 使用调试命令直接连接:
bash npx mcp-remote http://localhost:8787/sse
- 清除认证文件:
bash rm -rf ~/.mcp-auth