Weather MCP 服务器

一个模型上下文协议 (MCP) 服务器，通过 Claude for Desktop 提供天气信息。此服务器与美国国家气象局 API 集成，为美国各地提供天气预报和警报。作为 MIT MCP 黑客马拉松（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 环境：

# 创建并激活虚拟环境
uv venv
source .venv/bin/activate

# 安装依赖
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. 示例查询：
   • "萨克拉门托的天气怎么样？"
   • "德克萨斯州有哪些有效的天气警报？"

故障排除

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

API 参考

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

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

关于 MIT MCP 黑客马拉松

该项目是作为 MIT MCP 黑客马拉松（2025 年 4 月）期间的教程的一部分创建的，该教程旨在向开发人员介绍模型上下文协议，并帮助项目/初创公司启动他们自己的 MCP 服务器。该黑客马拉松是 MIT NANDA（网络代理和去中心化 AI）中心倡议的一部分。

许可证

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