Weather 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 Desktop 应用程序

uv 包管理器安装

# 在 macOS 和 Linux 上。
curl -LsSf https://astral.sh/uv/install.sh | sh

# 在 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. 通过将以下内容添加到 claude_desktop_config.json 来配置您的 MCP 服务器：

    "mcpServers": {
        "weather": {
            "command": "C:/Users/"输入您的用户名"/.local/bin/uv.exe",
            "args": [
                "--directory",
                "main.py 的目录位置",
                "run",
                "main.py"
            ]
        }
    }
   }
   
   

用法

运行 main.py python main.py

可用的 API 工具

打开 Claude Desktop，您会看到：2 个可用的 MCP 工具（在搜索栏的右侧）

<img src="https://github.com/user-attachments/assets/d3d2a756-a416-4236-99f8-21884139fc03" height="300px" width=auto />

<p>您现在可以向 Claude 询问实时天气相关问题</p>