Remote MCP Server on Cloudflare

基本能力

产品定位

Remote MCP Server是一个远程MCP服务器，旨在为开发者提供一个基于Cloudflare Workers的MCP服务，支持OAuth登录和工具调用。

核心功能

1. 远程MCP服务：在Cloudflare Workers上运行MCP服务器。
2. OAuth登录：支持用户通过OAuth登录。
3. 工具调用：允许通过MCP Inspector和Claude Desktop等工具调用定义的MCP工具。

适用场景

1. 开发调试：开发者可以在本地或Cloudflare Workers上运行MCP服务器，并通过MCP Inspector进行调试。
2. 工具集成：通过Claude Desktop等工具与MCP服务器集成，调用自定义工具。

工具列表

1. MCP Inspector：用于探索和调用MCP API的工具。
2. Claude Desktop：通过配置与MCP服务器集成，调用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，URL为http://localhost:8787/sse。
3. 登录后即可调用工具。

部署到Cloudflare

1. 创建KV命名空间： bash npx wrangler kv namespace create OAUTH_KV
2. 更新wrangler.jsonc并部署： bash npm run deploy

远程连接

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

调试命令

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

许可证

该项目遵循 None 开源许可条款。