Metadata-Version: 2.3
Name: accton-mcpdemo-weather
Version: 0.1.9
Summary: A MCP server for querying current weather and forecasts via OpenWeatherMap API
Author: 李元谷
Author-email: 李元谷 <accton@163.com>
Requires-Dist: httpx>=0.28.1
Requires-Dist: mcp[cli]>=1.27.2
Requires-Python: >=3.13
Description-Content-Type: text/markdown

# accton-mcpdemo-weather

一个基于 MCP (Model Context Protocol) 的天气查询服务器，通过 OpenWeatherMap API 提供实时天气和未来天气预报。

## 功能

- 🌍 查询全球城市的当前实时天气（温度、湿度、风速、气压、日出日落等）
- 📅 查询未来 5 天的天气预报（每 3 小时一个时段，含降水概率）
- 🌐 支持中文和英文城市名称

## 安装

```bash
pip install accton-mcpdemo-weather
```

## 配置

使用前需要设置环境变量：

```bash
export OPENWEATHER_API_KEY="your-api-key"
```

在 [OpenWeatherMap](https://openweathermap.org/api) 注册即可免费获取 API Key。

## 使用

### 命令行运行

```bash
accton-mcpdemo-weather
```

### 作为 MCP Server 配置

在 Claude Desktop 或其他 MCP 客户端的配置文件中添加：

```json
{
  "mcpServers": {
    "weather": {
      "command": "uvx",
      "args": ["accton-mcpdemo-weather"],
      "env": {
        "OPENWEATHER_API_KEY": "your-api-key"
      }
    }
  }
}
```

### 提供的工具

| 工具 | 说明 |
|------|------|
| `get_current_weather` | 获取指定城市的当前实时天气 |
| `get_weather_forecast` | 获取指定城市未来某天的天气预报 |
| `get_weather` | 综合查询：不传日期返回当前天气，传日期返回预报 |

## 开发

```bash
# 克隆仓库
git clone https://github.com/your-repo/accton-mcpdemo-weather.git
cd accton-mcpdemo-weather

# 安装依赖
uv sync

# 运行
uv run accton-mcpdemo-weather
```

## License

MIT
