readme.md•2.36 kB
# 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`:
```json
{
"mcpServers": {
"wttr-mcp-server": {
"command": "npx",
"args": ["wttr-mcp-server@latest"]
}
}
}
```
### 本地开发 / Local Development
```bash
# 安装依赖
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