Weather MCP Server

Weather MCP Server

site icon
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: 获取特定位置的天气预报

适用场景

  • 需要获取美国地区天气警报的应用
  • 需要查询特定位置天气预报的应用
  • 天气相关的自动化服务

工具列表

  1. get_alerts:
  2. 功能:获取美国某个州的天气警报
  3. 参数:state(两字母的美国州代码,如 'CA', 'NY')
  4. get_forecast:
  5. 功能:获取特定位置的天气预报
  6. 参数:latitude(纬度),longitude(经度)

常见问题解答

  1. 如果Claude for Desktop无法识别服务器:
  2. 检查配置文件路径是否正确
  3. 确认配置中的绝对路径是否正确
  4. 确保所有依赖项已安装
  5. 尝试重启Claude for Desktop
  6. 如果遇到天气API错误:
  7. 检查网络连接
  8. 确认坐标或州代码是否有效
  9. 注意:国家气象局API仅适用于美国位置

使用教程

使用依赖

  • Python 3.10或更高版本
  • uv包管理器(推荐)或pip

安装教程

  1. 克隆仓库:
git clone <your-repo-url>
cd simple_mcp_server
  1. 设置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

调试方式

  1. 运行服务器:
mcp dev main.py
  1. 配置Claude for Desktop:
  2. 打开配置文件:~/Library/Application Support/Claude/claude_desktop_config.json
  3. 添加配置: json { "mcpServers": { "weather": { "command": "uv", "args": [ "--directory", "/ABSOLUTE/PATH/TO/simple_mcp_server", "run", "main.py" ] } } }
  4. 替换/ABSOLUTE/PATH/TO/simple_mcp_server为实际项目路径
  5. 保存文件并重启Claude for Desktop

  6. 测试服务器:

  7. 打开Claude for Desktop
  8. 查找界面中的锤子图标
  9. 应该能看到两个工具:get_alertsget_forecast
  10. 尝试提问,如:
    • "What's the weather in NY?"
    • "What are the active weather alerts in NY?"

许可证

None