实
实时天气MCP服务器
@CodeByWaqas/weather-mcp-server
12 Stars
9.3k 次浏览
CodeByWaqas
更新于 2026-08-23
一个通过OpenWeatherMap API提供实时天气信息（包括温度、湿度、风速和日出/日落时间）的MCP服务器。
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"mcp-weather-project": {
"args": [
"--directory",
"/\u003cabsolute-path\u003e/weather-mcp-server/src/resources",
"run",
"server.py"
],
"command": "uv",
"env": {
"WEATHER_API_KEY": "YOUR_API_KEY"
}
}
}
}该服务需要配置环境变量：WEATHER_API_KEY
可用工具 （1 个）
该服务在 MCP 协议中暴露的工具，AI 可按需调用
weather 1 个参数 需填 1 项
It fetches the latest weather reports for the given city. Args: city (str): The city name for which weather reports are required. Returns: dict: The weather reports for the given city.
必填参数：city
服务介绍
Weather MCP Server
这是一个使用 OpenWeatherMap API 提供天气信息的现代代码协议（MCP）服务器。
特性
- 实时天气数据检索
- 温度采用公制单位
- 详细的天气信息包括：
- 温度
- 湿度
- 风速
- 日出/日落时间
- 天气描述
前提条件
- Python 3.12 或更高版本
- OpenWeatherMap API 密钥
安装
通过 Smithery 安装
要通过 Smithery 自动为 Claude Desktop 安装 Weather MCP Server：
npx -y @smithery/cli install @CodeByWaqas/weather-mcp-server --client claude
手动安装
- 克隆仓库
- 创建虚拟环境：
python -m venv .venv
source .venv/bin/activate # On Windows use: .venv\Scripts\activate
- 安装依赖项：
pip install -e .
设置说明
使用 Claude Desktop 设置
# claude_desktop_config.json
# Can find location through:
# Claude -> Settings -> Developer -> Edit Config
{
"mcpServers": {
"mcp-weather-project": {
"command": "uv",
"args": [
"--directory",
"/<absolute-path>/weather-mcp-server/src/resources",
"run",
"server.py"
],
"env": {
"WEATHER_API_KEY": "YOUR_API_KEY"
}
}
}
}
本地/开发设置说明
克隆仓库
git clone https://github.com/CodeByWaqas/weather-mcp-server
安装依赖项
安装 MCP 服务器依赖项：
cd weather-mcp-server
# Create virtual environment and activate it
uv venv
source .venv/bin/activate # MacOS/Linux
# OR
.venv/Scripts/activate # Windows
# Install dependencies
uv add "mcp[cli]" python-dotenv requests httpx
配置
- 将
src/resources/env.example复制到src/resources/.env - 在
.env文件中添加您的 OpenWeatherMap API 密钥：
WEATHER_API_KEY=your_api_key_here
使用
运行 Claude Desktop 并使用 LLM 检索天气信息
许可证
该项目根据 MIT 许可证授权 - 请参阅 LICENSE 文件获取详细信息。
