🚀 使用 Cloudflare Workers 搭建 MCP 服务器

本项目借助 Cloudflare Workers 搭建 MCP 服务器，模型上下文协议（MCP）作为开放标准，可实现 AI 代理和服务间的交互。通过搭建 MCP 服务器，能让 AI 助手直接访问你的 API。而 Cloudflare 工作者与 workers-mcp 包的结合，为构建 MCP 服务器提供了强大且可扩展的解决方案。

🚀 快速开始

准备工作

开始之前，请确保你具备以下内容：

• 一个 Cloudflare 账户
• Node.js 安装完成
• Wrangler CLI 已安装 (npm install -g wrangler)

创建 Cloudflare Worker

首先，初始化一个新的 Cloudflare Worker 项目：

npx create-cloudflare@latest my-mcp-worker
cd my-mcp-worker

然后，使用以下命令认证你的 Cloudflare 账户：

wrangler login

配置 Wrangler

更新你的 wrangler.toml 文件以包含正确的账户信息：

name = "my-mcp-worker"
main = "src/index.ts"
compatibility_date = "2025-03-03"
account_id = "your-account-id"

📦 安装指南

安装 MCP 工具

为了启用 MCP 支持，安装 workers-mcp 包：

npm install workers-mcp

运行以下命令进行设置：

npx workers-mcp setup

这将执行以下操作：

• 添加必要的依赖项
• 设置一个本地代理用于测试
• 配置 Worker 以符合 MCP 规范

💻 使用示例

基础用法

更新你的 src/index.ts 文件以定义你的 MCP 服务器：

import { WorkerEntrypoint } from 'cloudflare:workers';
import { ProxyToSelf } from 'workers-mcp';

export default class MyWorker extends WorkerEntrypoint<Env> {
  /**
   * 一个友好的问候语，来自你的 MCP 服务器。
   * @param name {string} 用户的名称。
   * @return {string} 个性化的问候语。
   */
  sayHello(name: string) {
    return `你好，来自一个 MCP 工作者，${name}！`;
  }

  /**
   * @ignore
   */
  async fetch(request: Request): Promise<Response> {
    return new ProxyToSelf(this).fetch(request);
  }
}

关键组件：

• WorkerEntrypoint：管理传入请求和方法的暴露。
• ProxyToSelf：确保 MCP 协议符合性。
• sayHello 方法：AI 助手可以调用的一个示例 MCP 函数。

高级用法

你可以通过集成外部 API 来扩展你的 MCP 服务器。以下是获取天气数据的示例：

export default class WeatherWorker extends WorkerEntrypoint<Env> {
  /**
   * 获取指定位置的天气数据。
   * @param location {string} 城市或邮政编码。
   * @return {object} 天气详情。
   */
  async getWeather(location: string) {
    const response = await fetch(`https://api.weather.example/v1/${location}`);
    const data = await response.json();
    return {
      temperature: data.temp,
      conditions: data.conditions,
      forecast: data.forecast
    };
  }

  async fetch(request: Request): Promise<Response> {
    return new ProxyToSelf(this).fetch(request);
  }
}

🔧 技术细节

部署 MCP 服务器

完成代码编写后，你可以使用以下命令部署你的 MCP 服务器：

npm run dev

这将启动一个开发环境下的 Worker。

测试

要测试你的 MCP 服务器，可以使用以下命令：

curl http://localhost:8787

根据你编写的代码，你可以获得相应的响应。

安全措施

为了保护你的 MCP 服务器，建议采取以下安全措施：

1. 配置合适的 CORS 策略。
2. 使用环境变量存储敏感信息。
3. 启用速率限制以防止滥用。

通过以上步骤，你已经成功搭建了一个基于 Cloudflare Workers 的 MCP 服务器，并能够集成外部 API 和进行基本的测试。