
Weather MCP Server

2025.03.27
0
Python天气服务API服务位置服务
Weather MCP Server 是一个基于 Model Control Protocol (MCP) 的简单天气服务,通过美国国家气象局 API 提供天气信息。该服务主要提供两种工具:获取特定美国州的天气警报和获取特定位置的天气预报。
View on GitHub
Overview
基本能力
产品定位
Weather MCP Server 是一个提供天气信息的服务,主要用于获取天气警报和天气预报。
核心功能
get_alerts
: 获取美国某个州的天气警报get_forecast
: 获取特定位置的天气预报
适用场景
- 需要获取美国地区天气警报的应用
- 需要查询特定位置天气预报的应用
- 天气相关的自动化服务
工具列表
get_alerts
:- 功能:获取美国某个州的天气警报
- 参数:
state
(两字母的美国州代码,如 'CA', 'NY') get_forecast
:- 功能:获取特定位置的天气预报
- 参数:
latitude
(纬度),longitude
(经度)
常见问题解答
- 如果Claude for Desktop无法识别服务器:
- 检查配置文件路径是否正确
- 确认配置中的绝对路径是否正确
- 确保所有依赖项已安装
- 尝试重启Claude for Desktop
- 如果遇到天气API错误:
- 检查网络连接
- 确认坐标或州代码是否有效
- 注意:国家气象局API仅适用于美国位置
使用教程
使用依赖
- Python 3.10或更高版本
uv
包管理器(推荐)或pip
安装教程
- 克隆仓库:
git clone <your-repo-url>
cd simple_mcp_server
- 设置Python环境(推荐使用
uv
):
# 安装uv(如果尚未安装)
curl -LsSf https://astral.sh/uv/install.sh | sh
# 创建并激活虚拟环境
uv venv
source .venv/bin/activate # Windows使用: .venv\Scripts\activate
# 安装依赖
uv add "mcp[cli]" httpx
或使用pip
:
python -m venv .venv
source .venv/bin/activate # Windows使用: .venv\Scripts\activate
pip install "mcp[cli]" httpx
调试方式
- 运行服务器:
mcp dev main.py
- 配置Claude for Desktop:
- 打开配置文件:
~/Library/Application Support/Claude/claude_desktop_config.json
- 添加配置:
json { "mcpServers": { "weather": { "command": "uv", "args": [ "--directory", "/ABSOLUTE/PATH/TO/simple_mcp_server", "run", "main.py" ] } } }
- 替换
/ABSOLUTE/PATH/TO/simple_mcp_server
为实际项目路径 -
保存文件并重启Claude for Desktop
-
测试服务器:
- 打开Claude for Desktop
- 查找界面中的锤子图标
- 应该能看到两个工具:
get_alerts
和get_forecast
- 尝试提问,如:
- "What's the weather in NY?"
- "What are the active weather alerts in NY?"
许可证
None