World Weather Online

World Weather Online — MCP 服务（Railway）

World Weather Online 的 MCP 服务。让 Claude、Cursor 等 AI 助手能够直接将 WWO 天气数据作为工具调用。

部署到 Railway

步骤 1 — 推送到 GitHub

1. 在 github.com 上创建一个新仓库（命名为 wwo-mcp-server）
2. 在此文件夹中打开终端并运行：

git init
git add .
git commit -m "Initial commit"
git remote add origin https://github.com/YOUR_USERNAME/wwo-mcp-server.git
git push -u origin main

步骤 2 — 在 Railway 上部署

1. 前往 https://railway.app 并使用 GitHub 注册 / 登录
2. 点击 New Project → Deploy from GitHub repo
3. 选择你的 wwo-mcp-server 仓库
4. Railway 会自动检测 Node.js 并部署

你的服务将通过类似以下的 URL 上线：

https://wwo-mcp-server-production.up.railway.app

步骤 3 — 添加自定义域名

1. 在 Railway 控制面板中，依次进入你的项目 → Settings → Networking → Custom Domain

2. 输入 mcp.worldweatheronline.com 并点击 Add

3. Railway 会显示类似以下的 CNAME 值：

   wwo-mcp-server-production.up.railway.app
   

4. 前往你的 DNS 提供商并添加：

   类型	名称	值
   CNAME	mcp	wwo-mcp-server-production.up.railway.app

5. SSL 证书会在几分钟内自动配置

步骤 4 — 测试

访问你的健康检查端点：

https://mcp.worldweatheronline.com/health

在 MCP Inspector 中测试：

https://mcp.worldweatheronline.com/mcp?key=YOUR_WWO_API_KEY

---

连接 AI 客户端

Claude Desktop

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "world-weather-online": {
      "url": "https://mcp.worldweatheronline.com/mcp?key=YOUR_API_KEY"
    }
  }
}

Cursor / Windsurf

添加到 .cursor/mcp.json：

{
  "mcpServers": {
    "world-weather-online": {
      "url": "https://mcp.worldweatheronline.com/mcp?key=YOUR_API_KEY"
    }
  }
}

---

可用工具

工具	描述
get_weather	当前天气状况 + 14 天预报
get_historical_weather	2008 年以来的历史天气
get_marine_weather	涌浪、潮汐、水温
get_ski_weather	山顶 / 山腰 / 山脚海拔预报
search_location	地点自动补全
get_astronomy	日出、日落、月相
get_timezone	当地时间 + UTC 时差
get_climate_averages	12 年月度气候平均值

---

本地开发

npm install
npm run dev

服务运行于 http://localhost:3000