
Remote MCP Server on Cloudflare

2025.03.31
0
TypeScript远程服务工具集成开发效率
my-mcp-server 是一个基于 Cloudflare Workers 的远程 MCP 服务器,支持 OAuth 登录。它允许开发者通过 MCP 协议与 Claude 等工具进行交互,提供工具调用和远程服务连接的能力。
View on GitHub
Overview
基本能力
产品定位
my-mcp-server 是一个远程 MCP 服务器,旨在为开发者提供工具调用和远程服务连接的能力,支持与 Claude 等工具的无缝集成。
核心功能
- 远程 MCP 服务:在 Cloudflare Workers 上运行,支持 OAuth 登录。
- 工具调用:通过 MCP 协议调用定义的工具。
- 本地开发支持:提供本地开发和调试的能力。
- 远程部署:支持部署到 Cloudflare Workers,实现远程访问。
适用场景
- 开发调试:开发者可以在本地运行和调试 MCP 服务。
- 工具集成:与 Claude 等工具集成,扩展其功能。
- 远程服务:部署到 Cloudflare Workers,提供远程 MCP 服务。
工具列表
- MCP Inspector:用于探索和调用 MCP API 的工具。
- 能力:连接 MCP 服务器,列出和调用定义的工具。
- Claude Desktop:通过 MCP 协议与 MCP 服务器交互的工具。
- 能力:调用远程 MCP 服务器提供的工具。
常见问题解答
- 连接问题:如果连接失败,可以尝试重启 Claude 或清除
~/.mcp-auth
文件。 - 调试工具:可以使用
npx mcp-remote
命令直接连接 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
- 在 Inspector 中配置 Transport Type 为
SSE
,URL 为http://localhost:8787/sse
。 - 登录后即可调用工具。
部署到 Cloudflare
- 创建 KV 命名空间:
bash npx wrangler kv namespace create OAUTH_KV
- 更新
wrangler.jsonc
文件。 - 部署:
bash npm run deploy
远程连接
- 使用 MCP Inspector 连接远程服务器:
bash npx @modelcontextprotocol/inspector@latest
- 输入
workers.dev
URL 并连接。
调试命令
- 直接连接 MCP 服务器:
bash npx mcp-remote http://localhost:8787/sse
- 清除认证文件:
bash rm -rf ~/.mcp-auth
许可证
None