Weather MCP Server

天气 MCP 服务

概述

本项目实现了一个模型上下文协议（MCP）服务，使 AI 助手（例如 Claude）能够与美国国家气象局（NWS）API 交互。该服务可提供指定位置的实时天气预警和预报。

功能

• 获取美国指定州的有效天气预警。
• 获取指定经纬度的天气预报。
• 使用 FastMCP 框架为 AI 交互提供工具。

使用的技术

• Python
• FastMCP
• httpx（用于异步 HTTP 请求）

前提条件

运行本项目之前，请确保已安装：

• Python（建议使用 3.11.6 或更高版本）
• uv 包管理器（pip install uv）
• httpx（pip install httpx）
• fastmcp（pip install fastmcp）
• Claude 桌面应用

uv 包管理器安装

# On macOS and Linux.
curl -LsSf https://astral.sh/uv/install.sh | sh

# On Windows.
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

添加到 PATH

安装与设置

1. 克隆仓库： git clone https://github.com/ankushmehta123/weather-mcp-server.git

2. 安装依赖： pip install -r requirements.txt

3. 在 MCP 服务配置中添加以下内容 claude_desktop_config.json:

    "mcpServers": {
        "weather": {
            "command": "C:/Users/"enter_your_username"/.local/bin/uv.exe",
            "args": [
                "--directory",
                "directory_location of main.py",
                "run",
                "main.py"
            ]
        }
    }
   }
   

Usage

Run main.py python main.py

Available API Tools

Open Claude Desktop, you would see: 2 MCP tools available (at right-side of the search-bar)

You can ask real-time weather-related questions to Claude now