🚀 天气 MCP 服务器

天气 MCP 服务器是一个提供天气信息的模型上下文协议（MCP）服务器，它集成于桌面版的 Claude 中。该服务器借助国家气象局 API，能为美国境内的任意位置提供天气预报和警报服务。此项目是作为 MIT MCP 黑客马拉松活动的一部分于 2025 年 4 月创建的。

🚀 快速开始

本服务器集成于桌面版 Claude，借助国家气象局 API 为美国境内提供天气服务。按以下步骤操作，即可快速使用：

1. 完成安装与配置（具体步骤见后续章节）。
2. 启动桌面版 Claude。
3. 查看锤子 🔨 图标以确认服务器已连接。
4. 发起示例查询，如 "Sacramento 的天气怎么样？" 或 "Texas 有哪些活跃的天气警报？"

✨ 主要特性

• get_forecast：使用经纬度获取任何美国位置的详细天气预报。
• get_alerts：根据州代码检索特定州内的活跃天气警报。

📦 安装指南

配置要求

• Python 3.10 或更高版本。
• uv 包管理器。
• 桌面版 Claude。
• 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. 创建或编辑桌面版 Claude 的配置文件 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "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。
2. 查看锤子 🔨 图标以确认服务器已连接。
3. 示例查询：
   • "Sacramento 的天气怎么样？"
   • "Texas 有哪些活跃的天气警报？"

故障排除

• 检查 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 黑客马拉松（2025 年 4 月）教程的一部分，旨在向开发者介绍模型上下文协议，并帮助项目或初创公司启动自己的 MCP 服务器。该黑客马拉松活动是 MIT 纳达（NANDA，网络化代理和分散式人工智能）枢纽计划的一部分。

📄 许可证

该项目遵循原始教程的许可声明：模型上下文协议