MCP-Enabled Cloudflare Worker for Claude

MCP-Enabled Cloudflare Worker for Claude

site icon
2025.03.07 1
TypeScriptAPI 网关数据查询网络代理内容生成位置服务开发效率
cf-mcp-server 是一个基于 Cloudflare Worker 实现的 Model Context Protocol (MCP) 服务,它允许 Claude 通过对话直接访问各种外部服务和 API。该服务提供了天气信息查询、IP 地理定位、网页搜索和 HTTP 请求代理等功能,旨在增强 Claude 的能力,使其能够执行更复杂的任务。
View on GitHub

Overview

基本能力

产品定位

cf-mcp-server 是一个增强 Claude 能力的中间件服务,通过 MCP 协议为 Claude 提供外部 API 访问能力。

核心功能

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

适用场景

  • 需要 Claude 提供实时天气信息的场景
  • 需要 Claude 进行 IP 地址分析的场景
  • 需要 Claude 执行网页搜索的场景
  • 需要 Claude 与外部 API 交互的场景

工具列表

  1. getWeatherData(cityName: string) - 获取指定城市的天气数据
  2. getIpDetails(ipAddr: string) - 获取 IP 地址的地理位置信息
  3. googleWebSearch(query: string, num?: number) - 执行 Google 搜索
  4. makeRequest(url: string, method: string, params?: object) - 发起自定义 HTTP 请求

常见问题解答

  • API 响应问题:检查是否在 Cloudflare Dashboard 中设置了正确的环境变量
  • 特定功能无法工作:可能需要获取相应的 API 密钥
  • 不需要的功能:可以在 src/index.ts 中注释掉相关代码

使用教程

使用依赖

  • Node.js 和 npm
  • Cloudflare 账户

安装教程

  1. 安装 Wrangler CLI
npm install -g wrangler
  1. 登录 Cloudflare
wrangler login
  1. 克隆仓库
git clone https://github.com/anishgowda21/cf-mcp-server.git
cd cf-mcp-server
  1. 安装依赖
npm install
  1. 设置 MCP
npx workers-mcp setup

配置

需要在 Cloudflare Dashboard 中设置以下环境变量: - OPENWEATHERMAP_API_KEY (天气数据) - IPINFO_API_KEY (IP 地理定位) - GOOGLE_API_KEY (网页搜索) - GOOGLE_CX (网页搜索)

部署

npm run deploy

调试方式

  • 检查环境变量是否正确设置
  • 检查 API 密钥是否有效
  • 检查 src/index.ts 中的代码是否正确

许可证

None