Weather MCP Server

这是一个使用美国国家气象局 API 提供天气信息的模型上下文协议 (MCP) 服务器。

项目结构

weather/
├── mcp-server/           # MCP 服务器实现
│   └── weather.py       # 主要服务器代码
├── pyproject.toml       # 项目配置和依赖
└── README.md           # 本文件

功能

• 获取美国各州的天气警报
• 获取特定地点的详细天气预报

前提条件

• Python 3.12 或更高版本
• uv 包管理器

安装

1. 创建并激活虚拟环境：

uv venv
source .venv/bin/activate  # 在 Unix/macOS 上
# 或
.venv\Scripts\activate  # 在 Windows 上

2. 安装依赖：

uv pip install -e .

用法

运行服务器：

uv run weather-server

服务器公开了两个工具：

1. get_alerts(state): 获取美国州的天气警报

   • 示例：get_alerts("CA") 获取加利福尼亚州的警报

2. get_forecast(latitude, longitude): 获取某个位置的天气预报

   • 示例：get_forecast(38.5816, -121.4944) 获取加利福尼亚州萨克拉门托的天气预报

配置

要将此服务器与 Claude for Desktop 一起使用：

1. 打开 ~/Library/Application Support/Claude/claude_desktop_config.json
2. 添加以下配置：

{
    "mcpServers": {
        "weather": {
            "command": "/Users/zhihaoouyang/.local/bin/uv",
            "args": [
                "--directory",
                "/Users/zhihaoouyang/Desktop/code/weather",
                "run",
                "weather-server"
            ]
        }
    }
}

3. 重启 Claude for Desktop

注意

此服务器使用美国国家气象局 API，该 API 仅提供美国境内地点的数据。