AI导哈

远程MCP服务器

一个部署在Cloudflare Workers上的生产级远程MCP服务器，实现问候工具和网络搜索功能，兼容Cursor和Claude Desktop等AI助手。

  • by ivannafigueroa
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 ivannafigueroa/remote-mcp-server

使用说明

Cloudflare上具有Web搜索功能的远程MCP服务器

部署在Cloudflare Workers上的生产就绪远程MCP（模型上下文协议）服务器，实现了问候工具和网络搜索功能。该服务器演示了如何构建和部署可供Cursor和Claude Desktop等AI助手使用的自定义工具。

概述

本项目可作为以下方面的参考实施：

  • 构建自定义MCP服务器
  • 实现OAuth身份验证
  • 将MCP服务器部署到Cloudflare Workers
  • 将AI助手连接到自定义工具
  • 整合网络搜索功能

特性

  • 🚀 部署在Cloudflare Workers上的远程MCP服务器
  • 🔐 用于安全访问的OAuth身份验证
  • 👋 用于测试MCP功能的简单问候工具
  • 🔍 用于实时信息检索的Web搜索工具
  • 🤖 与Cursor和Claude桌面兼容
  • 📊 内置MCP检查器支持
  • 📦 易于本地开发设置
  • 🛠️ 生产就绪部署配置

先决条件

  • Node.js 18或更高版本
  • pnpm包管理器
  • Cloudflare帐户（用于部署）
  • Git
  • 用于web搜索服务的API密钥（可选）

地方发展

  1. 克隆存储库：
# Using HTTPS
git clone https://github.com/cloudflare/ai.git

# Or using SSH
git clone git@github.com:cloudflare/ai.git
  1. 安装依赖项：
cd ai
pnpm install
  1. 配置环境变量（可选）：
# Create a .env file
cp .env.example .env

# Add your web search API key if needed
WEB_SEARCH_API_KEY=your_api_key_here
  1. 启动开发服务器：
npx nx dev remote-mcp-server

服务器将在以下时间可用 http://localhost:8787/

集成指南

连接到游标

  1. 打开光标并导航到设置>AI设置
  2. 在MCP配置部分，添加：
{
  "mcpServers": {
    "greeting": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:8787/sse"
      ]
    },
    "webSearch": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:8787/sse"
      ]
    }
  }
}
  1. 重新启动游标
  2. 出现提示时，使用任何电子邮件和密码登录（用于测试的模拟身份验证）
  3. 通过以下方式测试工具：
    • 让Cursor问候某人
    • 请求查询的web搜索结果

连接到克劳德桌面

  1. 打开克劳德桌面，进入“设置”>“开发人员”>“编辑配置”
  2. 添加以下配置：
{
  "mcpServers": {
    "greeting": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:8787/sse"
      ]
    },
    "webSearch": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:8787/sse"
      ]
    }
  }
}
  1. 重新启动克劳德桌面
  2. 使用任何电子邮件和密码登录
  3. 通过以下方式测试工具：
    • 请克劳德问候某人
    • 请求查询的web搜索结果

MCP检验员测试

  1. 启动检查器：
npx @modelcontextprotocol/inspector
  1. 打开 http://localhost:5173 在您的浏览器中
  2. 配置连接：
    • 将传输类型设置为 SSE
    • 进入 http://localhost:8787/sse 作为MCP服务器URL
    • 点击“连接”
  3. 使用任何电子邮件和密码登录
  4. 测试两个工具：
    • 使用问候工具发送问候
    • 使用网络搜索工具搜索信息

可用工具

问候工具

  • 生成个性化问候的简单工具
  • 用法：让人工智能直呼某人的名字
  • 示例：“请问候约翰”

网络搜索工具

  • 执行实时网络搜索
  • 返回相关搜索结果
  • 用法：让AI搜索信息
  • 示例：“搜索有关AI的最新消息”

部署

部署到Cloudflare

  1. 创建KV命名空间：
npx wrangler kv namespace create OAUTH_KV
  1. 将KV命名空间ID添加到 wrangler.jsonc
  2. 在Cloudflare中配置环境变量：
    • 转到Workers>你的Worker>设置>变量
    • 如果需要，添加您的网络搜索API密钥
  3. 部署到Cloudflare：
npm run deploy

连接到已部署的服务器

在Cursor或Claude Desktop中更新您的配置，以使用您员工的URL：

{
  "mcpServers": {
    "greeting": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://your-worker-name.your-account.workers.dev/sse"
      ]
    },
    "webSearch": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://your-worker-name.your-account.workers.dev/sse"
      ]
    }
  }
}

故障排除

常见问题

  1. 连接问题

    • 验证服务器是否在本地运行
    • 检查端口8787是否可用
    • 确保防火墙没有阻止连接

  2. 身份验证问题

    • 清除身份验证文件：
    rm -rf ~/.mcp-auth
    • 重新启动应用程序
    • 请尝试重新登录

  3. 工具不工作

    • 验证配置是否正确
    • 检查浏览器控制台是否有错误
    • 查看服务器日志是否有任何问题

  4. Web搜索问题

    • 验证API密钥配置是否正确
    • 检查您是否已达到API费率限制
    • 确保您的搜索查询格式正确

调试

  1. 直接测试连接：
npx mcp-remote http://localhost:8787/sse
  1. 检查服务器日志：
npx wrangler tail
  1. 监控网络搜索请求：
npx wrangler tail --format=pretty

贡献

欢迎投稿！请随时提交拉取请求。

许可证

此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。

支持

如果您遇到任何问题或有疑问：

相关 MCP