天气查询服务

一个轻量级的MCP服务器,提供美国天气预报和警报功能,与Claude for Desktop集成。

  • by Ankesh-53669
  • 本地部署
  • 更新于
在 GitHub 查看 ankesh-53669/mcp-weather-server

使用说明

🌤️ MCP气象服务器

这是一个轻量级的MCP(模型上下文协议)服务器,使用 FastMCP。它与 Claude桌面版 并公开了有用的工具,如:

  • 🌦️ 美国天气预报和警报

📋 特性

工具 说明
get_forecast 按坐标获取5个周期的天气预报
get_alerts 列出美国某个州的当前天气警报

🧰 先决条件


⚙️ 安装说明

1.📥 安装桌面版Claude

从以下位置下载并安装:
👉 https://www.anthropic.com/claude

一旦安装, 打开克劳德一次 以生成其配置目录。


2.📦 安装 uv (一次性设置)

打开PowerShell并运行:

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

然后 重新启动终端,或运行:

$env:Path = "C:\Users\admin\.local\bin;$env:Path"

3.📁 克隆存储库

git clone https://github.com/your-username/mcp-weather-and-quotes.git
cd mcp-weather-and-quotes

4.🐍 设置Python环境

uv venv
.venv\Scripts\activate         # On Windows
# OR
source .venv/bin/activate        # On macOS/Linux

uv add mcp[cli] httpx

5.🧠 配置Claude以检测MCP服务器

在VS Code或记事本中打开此文件:

code "$env:AppData\Claude\claude_desktop_config.json"

如果文件不存在,请创建它。然后粘贴以下JSON配置:

{
  "mcpServers": {
    "weather": {
      "command": "C:\\Users\\admin\\.local\\bin\\uv.exe",
      "args": [
        "--directory",
        "C:\\Users\\admin\\mcp-weather-and-quotes",
        "run",
        "weather.py"
      ]
    }
  }
}

🔁 确保所有路径都是正确和绝对的。使用双反睫毛(\\)或正斜杠(/).


6.▶️ 运行MCP服务器

从项目目录中,运行:

uv run weather.py

这将使用STDIO启动您的MCP服务器。


🧪 使用Claude中的工具

  1. 重新启动桌面版的Claude
  2. 点击 滑块图标 (右上角)打开工具
  3. 您应该看到以下工具:
    • get_forecast
    • get_alerts

💬 示例提示尝试

  • "What's the forecast for 38.58, -121.49?"
  • "Any active alerts in Texas?"

Claude将自动决定是否调用您的工具并显示结果。


📂 项目结构

mcp-weather-and-quotes/
├── weather.py                # Main MCP server code
├── README.md                 # This file
└── .venv/                    # Virtual environment (optional)

🙏 使用的API

  • 美国天气:https://api.weather.gov

📝 许可证

MIT许可证——使用它,分享它,扩展它!