
天气 MCP 服务器

2025.04.22
0
Python天气服务空气质量监测位置服务
天气 MCP 服务器是一个基于 OpenWeather API 的 Model Context Protocol (MCP) 服务器,主要用于获取全球城市的详细天气预报和空气质量信息。该服务器支持最多5天的天气预报查询,并能提供实时的空气质量数据。适用于需要天气信息的各种应用场景。
View on GitHub
Overview
基本能力
产品定位
天气 MCP 服务器是一个专门用于获取天气数据和空气质量信息的 MCP 服务器,通过 OpenWeather API 提供全球城市的天气服务。
核心功能
- 获取任何城市的详细天气预报(最多5天)
- 获取任何城市的当前空气质量信息
适用场景
- 需要集成天气信息的应用程序
- 需要实时空气质量数据的服务
- 天气预报查询工具
工具列表
- OpenWeather API:用于获取天气和空气质量数据
- FastMCP 框架:实现 MCP 协议
- Python requests 库:进行 API 交互
常见问题解答
- 如果遇到关于 API 密钥的错误,确保在命令行参数中正确提供了 API 密钥
- 确保网络可以访问 OpenWeather API
- 检查 MCP 客户端中的服务器配置是否正确
使用教程
使用依赖
- Python 3.11+
- OpenWeather API 密钥(可在 OpenWeather 获取)
- Anthropic Claude Desktop 应用(或其他 MCP 客户端)
- UV 包管理工具(https://github.com/astral-sh/uv)
安装教程
- 克隆仓库
bash git clone https://github.com/odinggg/weather-mcp.git cd weather-mcp
- 连接到 MCP 服务器
将以下 JSON 配置添加到您的 MCP 客户端(例如 Claude Desktop)中:
json { "mcpServers": { "weather": { "command": "uv", "args": [ "--directory", "/your/path/to/weather-mcp", "run", "-m", "weather_mcp_server.main", "--api-key", "xxxxxxxxxxxxxxx" ] } } }
对于 Claude Desktop,将此保存为claude_desktop_config.json
,位置在:~/Library/Application Support/Claude/claude_desktop_config.json
调试方式
- 使用示例提示测试服务器功能:
- "未来 3 天北京的天气预报是什么?"
- "现在上海的空气质量如何?"
- 检查日志文件以查看服务器运行状态