Wttr.in MCP Server

一个基于 Model Context Protocol (MCP) 的天气服务器，通过 wttr.in 免费天气 API 提供天气查询和日期时间查询功能。

A Model Context Protocol server that provides weather forecast and datetime query features through the free wttr.in weather API.

功能特性 / Features

获取实时天气数据 / Get real-time weather data
获取三天天气预报 / Get 3-day weather forecast
支持多种位置格式（城市名、邮政编码、经纬度坐标）/ Support multiple location formats (city name, postal code, coordinates)
获取当前日期时间（支持自定义时区）/ Get current date and time (with timezone support)
完整的中文天气描述 / Full Chinese weather description

工具说明 / API Tools

此 MCP 服务器提供以下两个工具：

get_weather_wttr

获取指定地点的天气预报数据。

参数 / Parameters:

location (必填): 需要查询的城市名称、邮政编码或经纬度坐标
- 示例: 'beijing', '90210', '40.71,-74.00'
days (可选): 预报类型，默认为 '3d'
- 'now' - 获取实时天气
- '3d' - 获取三天天气预报

返回内容:

实时天气：温度、体感温度、风速、风向、湿度、气压、紫外线指数
三天预报：每日最高/最低温、平均温度、日出日落时间、降水概率等

get_datetime

获取当前日期和时间。

参数 / Parameters:

timezone (可选): 时区，默认为 'Asia/Shanghai'
- 示例: 'America/New_York', 'Europe/London'

返回内容:

指定时区的当前日期和时间

使用方法 / Usage with MCP Host

在 Claude Desktop 中使用 / With Claude Desktop

将以下配置添加到 claude_desktop_config.json:

{
  "mcpServers": {
    "wttr-mcp-server": {
      "command": "npx",
      "args": ["wttr-mcp-server@latest"]
    }
  }
}

本地开发 / Local Development

# 安装依赖
npm install

# 构建项目
npm run build

# 在配置文件中使用本地路径
{
  "mcpServers": {
    "wttr-mcp-server": {
      "command": "node",
      "args": ["/path/to/wttr-mcp-server/dist/index.js"]
    }
  }
}

技术栈 / Tech Stack

TypeScript
Model Context Protocol SDK
Zod (参数验证)
wttr.in API (免费天气服务)

许可证 / License

ISC

HeFeng Weather