
Remote MCP Server on Cloudflare

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服务部署和调试环境。
核心功能
- 支持OAuth登录
- 提供本地和云端部署选项
- 支持通过MCP Inspector和Claude Desktop等工具进行交互
- 允许调用定义的MCP工具
适用场景
- 开发者在本地调试MCP服务
- 在Cloudflare Workers上部署远程MCP服务
- 通过Claude Desktop等客户端与MCP服务交互
工具列表
- MCP Inspector:用于探索和调用MCP API的工具,支持SSE传输类型。
- Claude Desktop:通过配置连接到MCP服务器,调用MCP工具。
- mcp-remote:命令行工具,用于直接连接到MCP服务器。
常见问题解答
- 如何调试连接问题?
- 重启Claude或尝试使用命令行工具
npx mcp-remote
直接连接。 - 清除
~/.mcp-auth
目录下的文件。
使用教程
使用依赖
- 克隆仓库:
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中选择SSE传输类型,输入
http://localhost:8787/sse
作为MCP服务器URL。 - 使用命令行工具调试:
bash npx mcp-remote http://localhost:8787/sse
- 清除认证文件:
bash rm -rf ~/.mcp-auth
部署到Cloudflare
- 创建KV命名空间:
bash npx wrangler kv namespace create OAUTH_KV
- 更新
wrangler.jsonc
文件,添加KV命名空间ID。 - 部署:
bash npm run deploy
远程连接
- 使用MCP Inspector连接远程服务器:
bash npx @modelcontextprotocol/inspector@latest
- 输入
workers.dev
URL作为MCP服务器URL。 - 更新Claude配置,指向远程服务器URL。
许可证
None