# 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