Weather CLI

一个基于 MCP (Model Control Protocol) 的天气查询工具，支持命令行和服务器模式，使用 wttr.in API 获取全球天气信息。

功能特点

获取全球任何位置的实时天气信息
默认查询北京天气
支持中文天气描述
显示详细天气信息（温度、湿度、风速等）
无需 API 密钥
支持命令行和 MCP 服务器两种使用模式

什么是 MCP？

MCP (Model Control Protocol) 是一个轻量级的服务协议，用于构建和部署机器学习模型服务。在本项目中，我们使用 MCP：

提供标准化的服务接口
支持异步操作
便于集成到其他系统
支持多种传输协议（stdio、TCP、WebSocket 等）

安装

# 克隆仓库
git clone https://github.com/liye71023326/weather-cli.git
cd weather-cli

# 使用 uv 安装（推荐）
uv pip install -e .

# 或使用 pip 安装
pip install -e .

使用方法

1. 命令行模式

直接使用 weather-cli 命令：

# 查询北京天气（默认）
weather-cli forecast

# 查询上海天气
weather-cli forecast --latitude 31.2304 --longitude 121.4737

# 查询广州天气
weather-cli forecast --latitude 23.1291 --longitude 113.2644

2. MCP 服务器模式

启动服务器

# 方式 1：使用 Python 直接运行
python run_server.py

# 方式 2：使用 MCP CLI 工具运行
mcp run weather

使用 MCP 客户端查询天气

在另一个终端中：

# 查询北京天气（默认经纬度）
mcp call weather get_forecast

# 查询指定位置天气
mcp call weather get_forecast --latitude 31.2304 --longitude 121.4737

服务器 API 说明

get_forecast 接口
- 功能：获取指定位置的天气预报
- 参数：
  - latitude: 纬度，范围 -90 到 90（默认：39.9042，北京）
  - longitude: 经度，范围 -180 到 180（默认：116.4074，北京）
- 返回：天气信息字符串，包含：
  - 城市名称
  - 当前天气状况
  - 温度和体感温度
  - 湿度和气压
  - 风向和风速
  - 能见度和云量
  - 降水量
get_alerts 接口
- 功能：获取天气预警信息（暂未实现）
- 参数：
  - state: 地区代码
- 返回：提示信息

常用城市经纬度

北京：39.9042, 116.4074（默认）
上海：31.2304, 121.4737
广州：23.1291, 113.2644
深圳：22.5431, 114.0579
成都：30.5728, 104.0668
武汉：30.5928, 114.3055
西安：34.3416, 108.9398
杭州：30.2741, 120.1551

开发

系统要求

Python 3.13 或更高版本
httpx：用于异步 HTTP 请求
mcp[cli]：MCP 协议实现

项目结构

weather-cli/
├── weather/
│   ├── __init__.py  # MCP 服务器实现和天气 API 集成
│   └── cli.py       # 命令行界面实现
├── run_server.py    # MCP 服务器启动脚本
├── pyproject.toml   # 项目配置
├── .gitignore      # Git 忽略配置
└── README.md       # 本文件

扩展开发

如果你想扩展这个项目，可以：

添加新的天气数据源
实现更多天气相关功能（如未来天气预报）
添加其他传输协议支持
实现数据缓存机制
实现天气预警功能
添加更多城市的默认经纬度

贡献

欢迎提交 Issue 和 Pull Request 来改进这个项目！

许可证

MIT License

致谢

wttr.in - 提供天气数据
httpx - 异步 HTTP 客户端
mcp - Model Control Protocol 实现
FastMCP - MCP 的快速实现框架