🚀 天气 MCP 服务器
这是一个基于 FastMCP 构建的天气查询服务器，能为用户提供全球城市的天气信息查询服务，满足不同用户对天气数据的需求。
✨ 主要特性
- 🌍 支持全球城市天气查询，无论您身处何地，都能轻松获取当地天气。
- 🌡️ 提供温度、湿度和天气描述信息，让您全面了解天气状况。
- 🔄 支持摄氏度和华氏度温度单位切换，满足不同用户的使用习惯。
- 🛠️ 基于 Model Context Protocol (MCP) 实现，确保系统的高效稳定运行。
- 📝 完整的日志记录，方便后续问题排查和系统优化。
📦 安装指南
安装要求
- Python 3.8+
- OpenWeatherMap API 密钥
- uv (Python 包管理工具)
🚀 快速开始
- 克隆仓库：
git clone
cd weather-mcp-server
- 安装依赖：
make install
- 设置环境变量：
创建
.env文件并添加以下内容：
OPENWEATHER_API_KEY=你的OpenWeatherMap_API密钥
- 运行服务器：
make run
💻 使用示例
选项 1：使用 uvx（推荐）
使用 uvx 可以自动从 PyPI 安装包，无需克隆仓库。将以下配置添加到 Claude Desktop 的配置文件 claude_desktop_config.json 中：
{
"mcpServers": {
"weather-mcp-server": {
"command": "uvx",
"args": [
"weather-mcp-server"
],
"env": {
"OPENWEATHER_API_KEY": "你的OpenWeatherMap_API密钥"
}
}
}
}
选项 2：本地开发模式
- 克隆仓库并安装依赖：
git clone
cd weather-mcp-server
make install
- 设置环境变量：
创建
.env文件并添加以下内容：
OPENWEATHER_API_KEY=你的OpenWeatherMap_API密钥
- 在 Claude Desktop 配置文件中添加：
{
"mcpServers": {
"weather": {
"command": "uv",
"args": [
"--directory",
"path/to/src/weather_mcp_server",
"run",
"weather-mcp-server"
],
"env": {
"OPENWEATHER_API_KEY": "你的OpenWeatherMap_API密钥"
}
}
}
}
配置文件位置：
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%/Claude/claude_desktop_config.json
重启 Claude Desktop 以加载新的 MCP 服务器。
🔧 技术细节
开发
本项目使用 Makefile 来简化常用命令。
可用命令
make install # 安装依赖
make format # 格式化代码
make lint # 运行代码检查
make clean # 清理临时文件
make run # 运行服务器
发布新版本
make release version=v0.1.0
📚 详细文档
MCP 工具
服务器提供以下 MCP 工具：
get_weather
获取指定城市的天气信息。
参数：
city: 城市名称（必填）units: 温度单位（可选，默认为 "metric"）- "metric": 摄氏度
- "imperial": 华氏度
示例请求：
{
"name": "get_weather",
"kwargs": {
"city": "Beijing",
"units": "metric"
}
}
示例响应：
{
"temperature": 20.5,
"humidity": 65,
"description": "晴",
"city": "Beijing"
}
现在您可以通过 Claude 使用自然语言查询天气，例如：
- "北京的天气如何？"
- "纽约当前的温度是多少？"
- "告诉我大阪的天气情况。"