Weather App

基本能力

产品定位

mcp-server-example 是一个基于 MCP 的天气应用程序，旨在为用户提供全球各地的天气信息，包括当前天气状况、天气预报和天气警报。

核心功能

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

适用场景

• 需要实时天气信息的用户
• 需要天气预报的旅行者
• 需要天气警报的应急响应人员
• 开发者需要集成天气数据的应用程序

工具列表

• 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 密钥和订阅状态

常见问题解答

无明确常见问题解答部分。

使用教程

使用依赖

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

安装教程

1. 克隆仓库：

bash git clone <repository-url> cd weather-app

1. 在根目录创建 .env 文件并添加 OpenWeatherMap API 密钥：

bash OPENWEATHER_API_KEY=your_api_key_here

1. 运行安装脚本：

bash ./scripts/install.sh

开发环境安装：

bash ./scripts/install.sh --dev

调试方式

运行天气应用程序：

./scripts/run_weather.sh

运行测试：

./scripts/run_tests.sh

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

./scripts/run_tests.sh --integration

运行预提交钩子：

uv run pre-commit run --all-files

许可证

该项目遵循 MIT 开源许可条款。