Remote MCP Server On Cloudflare Q3y

🚀 在Cloudflare上运行远程MCP服务器

本项目将帮助你搭建一个运行在Cloudflare Workers上的远程MCP服务器，并集成OAuth登录功能，让你可以轻松地与Claude Desktop和MCP检查器进行交互。

🚀 快速开始

本地开发

首先，你需要在本地环境中克隆仓库、安装依赖并启动本地服务。以下是具体的操作步骤：

# 克隆仓库
git clone git@github.com:cloudflare/ai.git

# 安装依赖
cd ai
npm install

# 启动本地服务
npx nx dev remote-mcp-server

启动成功后，你可以在浏览器中打开http://localhost:8787/查看效果。

💻 使用示例

将MCP检查器连接到你的服务器

你可以使用MCP检查器来探索新的MCP API，具体操作步骤如下：

1. 使用以下命令启动MCP检查器：npx @modelcontextprotocol/inspector。
2. 在检查器中，将传输类型切换为SSE，并在URL中输入http://localhost:8787/sse以连接到你的MCP服务器，然后点击“连接”。
3. 此时你会被重定向到一个（模拟）用户密码登录界面，输入任意电子邮件和密码进行登录。
4. 成功登录后，你将返回到MCP检查器，并能够列出和调用任何已定义的工具。

将Claude Desktop连接到本地MCP服务器

按照Anthropic的快速入门指南，在Claude Desktop中转到设置 > 开发者 > 编辑配置文件以找到你的配置文件。用文本编辑器打开该文件，并将其替换为以下内容：

{
  "mcpServers": {
    "math": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:8787/sse"
      ]
    }
  }
}

这样会运行一个本地代理，使Claude能够通过HTTP与你的MCP服务器通信。当打开Claude时，浏览器窗口应打开，并允许你登录。你应该在右下角看到可用的工具。

📦 安装指南

部署到Cloudflare

要将项目部署到Cloudflare，你需要完成以下步骤：

1. 注册并设置Upstash：
   • 前往Upstash注册一个免费账户。
   • 创建一个新的Postgres数据库，并获取连接字符串（格式为postgres://user:password@host:port/database）。
2. 更新配置文件：
   • 在项目的根目录下，创建或编辑.env文件，添加以下内容：

UPSTASH_URL=your_upstash_host
UPSTASH_USER=username
UPSTASH_PASSWORD=password

- 替换`your_upstash_host`、`username`和`password`为你的实际Upstash凭据。

3. 部署到Cloudflare Pages：
   • 初始化你的项目仓库为Git仓库（如果尚未完成）。
   • 创建一个package.json文件，包含以下内容：

{
  "name": "mcp-server",
  "version": "1.0.0",
  "scripts": {
    "dev": "npx nx dev remote-mcp-server",
    "build": "npx nx build --configuration production"
  },
  "dependencies": {
    "@nx/webpack": "^14.0.0",
    "express": "^4.18.2",
    "pg": "^8.11.3",
    "typescript": "^5.3.2",
    "@types/node": "^20.11.0"
  }
}

- 在项目的根目录下创建一个`tsconfig.json`文件，内容如下：

{
  "compilerOptions": {
    "target": "ES6",
    "module": "CommonJS",
    "outDir": "./dist",
    "rootDir": ".",
    "strict": true,
    "esModuleInterop": true,
    "skipLibCheck": true
  }
}

- 接下来，创建一个`pages.json`文件以配置Cloudflare Pages：

{
  "type": "static",
  "build": {
    "command": "npm run build",
    "directory": "./dist"
  },
  "routes": [
    "* => $latest"
  ]
}

- 现在，你可以将项目推送到GitHub或GitLab，并连接到Cloudflare Pages以进行部署。

🔧 调试

如果在部署或使用过程中遇到问题，请参考以下步骤进行调试：

1. 检查Cloudflare Pages的构建日志，确保所有依赖项正确安装且没有错误。
2. 验证Upstash凭据是否正确配置在.env文件中，并且没有拼写错误。
3. 确保MCP服务器在本地运行无误后，再尝试部署到生产环境。

通过以上步骤，你已经成功搭建了一个功能齐全的远程MCP服务器，并能够与Claude Desktop和MCP检查器无缝集成。