Skip to main content
Glama
smallwhitelz

Weather MCP Server

by smallwhitelz

Weather MCP Server

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

工具说明

get_weather_warning — 天气预警查询

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

参数

参数

类型

必填

说明

location

string

城市名称(如"北京")、LocationID 或经纬度(如"116.41,39.92")

get_weather — 城市天气查询

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

参数

参数

类型

必填

说明

location

string

城市名称或经纬度

days

number

预报天数,默认 3,最大 7

Related MCP server: MCP Weather Free

快速开始

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(必填)

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    An MCP server that provides real-time weather information, 4-day forecasts, and city search functionality for Chinese cities via the AMap API. It enables users to query weather data using city names or administrative codes through natural language interactions.
    1
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    An MCP server that provides real-time weather data, hourly forecasts, and daily summaries using the free Open-Meteo API with no API key required. It enables users to search for weather conditions by specific coordinates or city names across multiple measurement units.
    2
    MIT