天气 MCP 服务器

这是一个使用国家气象局 API 提供天气信息的 Model Context Protocol (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) 获取萨克拉门托（CA）的预报信息

配置方法

要在 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，仅支持获取美国境内的天气信息。