Remote MCP Server on Cloudflare

基本能力

产品定位

Remote MCP Server on Cloudflare 是一个用于快速部署和调试MCP服务的工具，支持远程连接和OAuth登录。

核心功能

1. 支持在Cloudflare Workers上部署MCP服务器。
2. 提供OAuth登录功能。
3. 支持通过MCP Inspector和Claude Desktop等工具进行交互。
4. 提供本地和远程调试能力。

适用场景

1. 开发者在本地快速测试MCP服务。
2. 在Cloudflare Workers上部署远程MCP服务。
3. 通过Claude Desktop等工具调用MCP服务。

工具列表

1. MCP Inspector: 用于探索和调用MCP API的工具。
2. Claude Desktop: 通过配置连接到MCP服务器，调用定义的工具。
3. mcp-remote: 命令行工具，用于直接连接到MCP服务器。

常见问题解答

1. 调试问题: 可以尝试重启Claude或直接通过命令行连接MCP服务器。
2. 认证问题: 清除~/.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. 配置Transport Type为SSE，输入MCP服务器URL http://localhost:8787/sse，点击"Connect"。
3. 登录后即可调用工具。

部署到Cloudflare

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

远程连接

1. 使用MCP Inspector连接远程服务器： bash npx @modelcontextprotocol/inspector@latest
2. 输入workers.dev URL，点击"Connect"。

调试命令

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

许可证

None