MCP-Enabled Cloudflare Worker for Claude

面向 Claude 的启用 MCP 的 Cloudflare Worker

此仓库包含一个实现了模型上下文协议（MCP）的 Cloudflare Worker，可让 Claude 在对话中直接访问各种外部服务和 API。

功能

此 Worker 提供以下工具供 Claude 使用：

• 天气信息：获取任意城市的当前天气数据
• IP 地理位置：查询任意 IP 地址的详细信息
• 网页搜索：执行 Google 搜索，并可自定义结果数量
• HTTP 请求代理：向任意端点发送自定义 HTTP 请求，并全面控制请求头、方法和请求体数据

设置说明

先决条件

• 已安装 Node.js 和 npm
• Cloudflare 账户

安装

1. 安装 Wrangler CLI

  npm install -g wrangler

2. 登录 Cloudflare

  wrangler login

3. 克隆此仓库

  git clone https://github.com/anishgowda21/cf-mcp-server.git
  cd cf-mcp-server

4. 安装依赖项

  npm install

5. 设置 MCP

  npx workers-mcp setup

配置

出于安全考虑，建议在 Cloudflare Dashboard 中设置以下环境变量，而不是将它们写入 wrangler.toml 文件：

• OPENWEATHERMAP_API_KEY（用于天气数据）
• IPINFO_API_KEY（用于 IP 地理位置）
• GOOGLE_API_KEY（用于网页搜索）
• GOOGLE_CX（用于网页搜索）

设置方法：

1. 前往 Cloudflare Dashboard
2. 导航至 Workers & Pages
3. 选择你的 Worker
4. 前往 Settings > Variables
5. 在“Environment Variables”下添加环境变量

注意：如果你不需要某项服务，可以不设置其 API 密钥。调用相应函数时会返回错误，但 Worker 的其他部分仍会继续运行。

部署

将你的 Worker 部署到 Cloudflare：

npm run deploy

与 Claude 搭配使用

部署完成后，你可以将 MCP 服务与 Claude 搭配使用。只需让 Claude 使用你的 Worker 执行各种任务：

• “获取东京的天气”
• “查询有关 IP 地址 8.8.8.8 的信息”
• “搜索网页，查找‘最新 AI 发展’”
• “向 https://example.com/api/data 发送 GET 请求”

Claude 会根据你的请求自动使用相应函数。

函数参考

getWeatherData(cityName: string)

获取指定城市的当前天气数据。

getIpDetails(ipAddr: string)

获取 IP 地址的详细地理位置信息。使用“me”可获取客户端 IP 的相关信息。

googleWebSearch(query: string, num?: number)

使用指定的查询词执行 Google 搜索，并返回指定数量的结果（1–10，默认值：5）。

makeRequest(url: string, method: string, params?: object)

使用指定的方法、请求头和请求体数据发送自定义 HTTP 请求。params 对象可以包含：

• headers：HTTP 请求头记录
• body：请求体（字符串或对象；对象会自动转换为字符串）

自定义

要修改 Worker 或添加新函数：

1. 编辑 src/index.ts
2. 向 MyWorker 类添加新方法，并使用 JSDoc 注释说明其功能
3. 使用 npm run deploy 进行部署

故障排除

• 如果 API 响应出现问题，请检查是否已在 Cloudflare Dashboard 中设置相应的环境变量
• 如果某个函数无法正常工作，可能需要获取相应的 API 密钥
• 对于不需要的函数，可以注释掉 src/index.ts 中的相关代码