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