关键词

ClaudeCloudflare Worker外部工具API 访问serverless

使用说明

项目简介

cf-mcp-server 是一个基于 Model Context Protocol (MCP) 构建的后端服务，部署在 Cloudflare Worker 上。它旨在为 Claude 等大型语言模型 (LLM) 提供访问外部数据和执行特定操作的能力。通过此 MCP 服务器，Claude 可以安全、可控地获取实时天气信息、查询 IP 地址详情、进行网页搜索，甚至发起自定义 HTTP 请求，从而扩展其功能边界，更好地服务用户。

主要功能点

  • 天气信息查询: 获取指定城市当前的详细天气数据。
  • IP 地理位置查询: 查询特定 IP 地址的地理位置和其他相关信息，也支持查询客户端自身的 IP 信息。
  • 网页搜索: 使用 Google Custom Search API 执行网页搜索，并返回 JSON 格式的搜索结果。
  • HTTP 请求代理: 允许 Claude 发起自定义的 HTTP 请求到任意 URL，支持设置请求方法、header 和 body。

安装步骤

  1. 安装 Wrangler CLI: 如果还没有安装 Cloudflare Wrangler CLI，请先安装： 
    npm install -g wrangler
  2. 登录 Cloudflare: 使用 Wrangler 登录你的 Cloudflare 账号： 
    wrangler login
  3. 克隆仓库: 克隆 GitHub 仓库到本地： 
    git clone https://github.com/anishgowda21/cf-mcp-server.git
cd cf-mcp-server
  4. 安装依赖: 安装项目依赖： 
    npm install
  5. 部署到 Cloudflare: 执行部署命令将 Worker 部署到 Cloudflare： 
    npm run deploy
    部署成功后，会得到一个 Cloudflare Worker 的 URL，例如 'https://cf-mcp-server.<your-cloudflare-subdomain>.workers.dev'。请记录这个 URL，后续配置 MCP 客户端时需要使用。

服务器配置

对于 MCP 客户端（例如 Claude），你需要配置连接到此 MCP 服务器的信息。配置信息通常为 JSON 格式，示例如下：

{
  "serverName": "cf-mcp-server",  // 自定义服务器名称，方便在客户端识别
  "command": "https://cf-mcp-server.<your-cloudflare-subdomain>.workers.dev" //  Cloudflare Worker 的 URL，替换为你的实际部署地址
  // "args": [] //  此服务器配置不需要额外的启动参数
}

注意:

  • 请将 '<your-cloudflare-subdomain>' 替换为你 Cloudflare 账号相关的子域名。
  • 上述 JSON 配置中，'command' 字段填写部署后 Cloudflare Worker 的 URL。'args' 字段为空数组，因为此 MCP 服务器不需要额外的启动参数。
  • 你需要在 Cloudflare Dashboard 中配置以下环境变量 (Settings -> Variables)，用于 API 鉴权和功能启用：
    • 'OPENWEATHERMAP_API_KEY': OpenWeatherMap API 密钥 (用于天气查询)
    • 'IPINFO_API_KEY': IPinfo API 密钥 (用于 IP 地理位置查询)
    • 'GOOGLE_API_KEY': Google Custom Search API 密钥 (用于网页搜索)
    • 'GOOGLE_CX': Google Custom Search Engine ID (用于网页搜索) 如果不需要某个功能，可以不设置对应的 API 密钥，但该功能将无法使用。

基本使用方法

在 Claude 等 MCP 客户端中配置好上述服务器信息后，即可通过自然语言指令调用 MCP 服务器提供的工具。例如，你可以向 Claude 提问：

  • "Get the weather for Tokyo" (查询东京天气)
  • "Look up information about IP address 8.8.8.8" (查询 IP 地址 8.8.8.8 的信息)
  • "Search the web for 'latest AI developments'" (搜索关于 "latest AI developments" 的网页)
  • "Make a GET request to https://example.com/api/data" (发起 GET 请求到 https://example.com/api/data)

Claude 会根据你的指令，自动调用 MCP 服务器上相应的工具来完成任务。

信息

分类

网页与API

访问项目