Weather MCP Server

基于和风天气 API 的 MCP 服务，为 AI 助手提供实时天气查询和气象预警能力。

工具说明

get_weather_warning — 天气预警查询

查询指定地区当前生效的气象灾害预警信息。

参数

参数	类型	必填	说明
location	string	是	城市名称（如"北京"）、LocationID 或经纬度（如"116.41,39.92"）

get_weather — 城市天气查询

查询指定城市的实时天气 + 未来多天预报。

参数

参数	类型	必填	说明
location	string	是	城市名称或经纬度
days	number	否	预报天数，默认 3，最大 7

快速开始

1. 申请 API Key

前往 console.qweather.com 注册并创建应用，获取 API Key。 免费版每天 1000 次调用，足够日常使用。

2. 安装依赖并构建

npm install
npm run build

3. 配置 Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "weather": {
      "command": "node",
      "args": ["/absolute/path/to/weather-mcp/dist/index.js"],
      "env": {
        "QWEATHER_API_KEY": "your_api_key_here"
      }
    }
  }
}

重启 Claude Desktop 即可使用。

项目结构

weather-mcp/
├── src/
│   ├── index.ts              # MCP Server 入口
│   ├── tools/
│   │   ├── warning.ts        # 天气预警查询逻辑
│   │   └── weather.ts        # 城市天气查询逻辑
│   └── utils/
│       └── qweather.ts       # 和风天气 HTTP 客户端封装
├── PRD.md                    # 产品需求文档
├── package.json
└── tsconfig.json

环境变量

变量名	说明
QWEATHER_API_KEY	和风天气 API Key（必填）