天气 MCP 服务器

What is 天气 MCP 服务器?

天气 MCP 服务器是一个基于 Model Context Protocol (MCP) 的工具，它通过 OpenWeather API 获取指定城市的天气预报（最长 5 天）和当前空气质量数据，专为希望在对话式 AI 客户端（如 Claude Desktop）中直接查询实时天气信息的用户设计。

How to use 天气 MCP 服务器?

安装需要 Python 3.11+、UV 包管理工具和 OpenWeather API 密钥。将仓库克隆到本地后，在 MCP 客户端配置中添加如下 JSON（需替换 /your/path/to/weather-mcp 和 API 密钥）。连接后，直接向 Claude 询问任意城市的天气或空气质量即可。

Key features of 天气 MCP 服务器

• 获取任意城市最长 5 天的详细天气预报
• 获取任意城市的当前空气质量信息
• 基于 OpenWeather API 提供实时数据
• 通过 FastMCP 框架实现标准 MCP 协议
• 支持 Claude Desktop 等 MCP 客户端集成

Use cases of 天气 MCP 服务器

• 在对话中快速查询未来几天的城市天气预报
• 实时了解某个城市的空气污染程度
• 将天气数据嵌入到 AI 工作流中（如规划行程）
• 为智能助手增加地理气象信息能力

FAQ from 天气 MCP 服务器

如何获取 OpenWeather API 密钥？

前往 OpenWeather 官网 注册并申请 API 密钥，该密钥需要在启动命令中通过 --api-key 参数传入。

运行天气 MCP 服务器需要哪些依赖？

需要 Python 3.11 及以上版本，以及 UV 包管理工具（https://github.com/astral-sh/uv）。服务器使用 FastMCP 框架和 Python requests 库与 OpenWeather API 交互。

如何将服务器连接到 Claude Desktop？

将配置 JSON 写入 claude_desktop_config.json，该文件位于 ~/Library/Application Support/Claude/ 目录下。确保 command 为 uv，且 args 中包含正确的仓库路径和 API 密钥。

遇到 API 密钥相关错误怎么办？

请检查命令行参数中 --api-key 的值是否正确。同时确认客户端配置文件中的 args 数组写法无误，密钥前后无多余空格。

网络或配置问题如何排查？

确保您的网络可以正常访问 OpenWeather API（api.openweathermap.org）。如果服务器依然不响应，重新检查 MCP 客户端的服务器配置路径和参数是否完全匹配。