Weather App

天气应用

基于命令行和 MCP 的天气应用，可提供全球各地的当前天气状况、预报和警报。

功能

• 获取任意地点的当前天气状况
• 获取每日天气预报
• 获取每小时天气预报
• 获取天气警报
• 根据坐标获取天气
• 自动检测位置
• 测试 API 连接
• 检查 API 密钥和订阅状态

安装

先决条件

• Python 3.12 或更高版本
• uv 包管理器

设置

1. 克隆此仓库：

   git clone <repository-url>
   cd weather-app
   

2. 在根目录中创建一个 .env 文件，并填入你的 OpenWeatherMap API 密钥：

   OPENWEATHER_API_KEY=your_api_key_here
   

   你可以从 OpenWeatherMap 获取 API 密钥。

3. 运行安装脚本：

   ./scripts/install.sh
   

   如需设置开发环境，请使用：

   ./scripts/install.sh --dev
   

使用方法

运行天气应用：

./scripts/run_weather.sh

这将启动 MCP 服务，其中包含以下可用工具：

• get_current_weather：获取当前天气状况
• get_forecast：获取每日天气预报
• get_hourly_forecast：获取每小时天气预报
• get_alerts：获取天气警报
• get_weather_by_coordinates：根据坐标获取天气
• get_user_location：获取你当前的位置
• test_api_connection：测试 API 连接
• check_api_key_and_subscription：检查你的 API 密钥和订阅状态

开发

代码风格和 Lint

本项目使用：

• Black 格式化代码
• isort 排序导入项
• Ruff 执行 Lint 检查
• mypy 检查类型

所有这些工具都在 pyproject.toml 文件中进行了配置。

Pre-commit 钩子

我们使用 pre-commit 钩子来确保代码质量。安装开发依赖后，钩子会自动设置。

手动安装 pre-commit 钩子：

uv run pre-commit install

手动运行 pre-commit 钩子：

uv run pre-commit run --all-files

测试

运行测试：

./scripts/run_tests.sh

运行测试并生成覆盖率报告：

./scripts/run_tests.sh --coverage

运行集成测试（需要 API 密钥）：

./scripts/run_tests.sh --integration

运行集成测试并生成覆盖率报告：

./scripts/run_tests.sh --integration --coverage

创建 MCP 服务

使用此项目作为模板创建你自己的 MCP 服务：

1. 安装项目及其开发依赖：

   ./scripts/install.sh --dev
   

2. 创建一个新的 Python 文件，实现你的 MCP 服务：

   import os
   from dotenv import load_dotenv
   from mcp.server.fastmcp import FastMCP
   
   # Load environment variables
   load_dotenv()
   
   # Initialize FastMCP server
   mcp = FastMCP("your-app-name")
   
   # Define your tools
   @mcp.tool
   async def your_tool(param1: str, param2: int) -> str:
       """Tool description."""
       # Your implementation here
       return "Result"
   
   # Run the server
   if __name__ == "__main__":
       mcp.run()
   

3. 运行你的服务：

   python your_server.py
   

许可证

本项目采用 MIT 许可证授权，详情请参阅 LICENSE 文件。