Weather MCP Server

Weather MCP Server

一个 Model Context Protocol（MCP）服务，可通过 Claude for Desktop 提供天气信息。该服务集成了美国国家气象局 API，为美国各地提供天气预报和预警。作为 MIT MCP Hackathon（2025 年 4 月）的一部分创建。

功能

• get_forecast：使用纬度和经度获取美国任意地点的详细天气预报
• get_alerts：使用州代码获取美国任意州当前生效的天气预警

要求

• Python 3.10 或更高版本
• uv 包管理器
• Claude for Desktop
• MCP SDK 1.2.0 或更高版本

安装

1. 确保已安装 uv：

curl -LsSf https://astral.sh/uv/install.sh | sh

2. 设置 Python 环境：

# Create and activate virtual environment
uv venv
source .venv/bin/activate

# Install dependencies
uv add "mcp[cli]" httpx

配置

1. 在 ~/Library/Application Support/Claude/claude_desktop_config.json 创建或编辑 Claude for Desktop 配置：

{
  "mcpServers": {
    "weather": {
      "command": "/path/to/uv",
      "args": [
        "--directory",
        "/absolute/path/to/weather",
        "run",
        "weather.py"
      ]
    }
  }
}

2. 将 /path/to/uv 替换为 uv 可执行文件的路径（使用 which uv 查找）
3. 将 /absolute/path/to/weather 替换为此项目目录的绝对路径

使用方法

1. 启动 Claude for Desktop
2. 查找锤子 🔨 图标，确认服务已连接
3. 示例查询：
   • “萨克拉门托的天气怎么样？”
   • “德克萨斯州当前有哪些天气预警？”

故障排除

• 查看 Claude 日志：~/Library/Logs/Claude/mcp*.log
• 确保配置中的所有路径都是绝对路径
• 使用 uv run weather.py 验证服务能否独立运行
• 检查端口 8001 是否未被其他进程占用

API 参考

该服务使用美国国家气象局 API：

• 基础 URL：https://api.weather.gov
• 使用的端点：
  • /alerts/active/area/{state} - 按州获取预警
  • /points/{lat},{lon} - 获取预报网格数据
  • /forecast - 获取详细天气预报

关于 MIT MCP Hackathon

本项目作为 MIT MCP Hackathon（2025 年 4 月）期间的一项教程而创建。该活动旨在向开发者介绍 Model Context Protocol，并帮助项目和初创公司启动自己的 MCP 服务。此次黑客松是 MIT NANDA（Networked Agents and Decentralized AI）中心计划的一部分。

许可证

本项目遵循 Model Context Protocol 的原始教程

截图