JinDaGe - weather-mcp-server-pyp MCP Details

article

README

🚀 天气 MCP 服务器

这是一个学习项目，旨在探索 Model Context Protocol (MCP) 概念。项目实现了一个简单的天气服务，借助 National Weather Service (NWS) API 提供天气警报和预报，为理解 MCP 提供了实践案例。

🚀 快速开始

此项目作为学习 MCP 的练习而创建，遵循文档： https://modelcontextprotocol.io/quickstart/server#core-mcp-concepts MCP 是一种协议，允许 AI 助手访问外部工具和数据源。该项目展示了如何为 Claude 或其他与 MCP 兼容的助手创建一个 MCP 服务器。

✨ 主要特性

get_alerts：获取美国某州的当前天气警报
get_forecast：根据经纬度获取特定位置的天气预报

📦 安装指南

克隆此仓库

安装依赖项：

pip install mcp httpx

或使用 uv：

uv pip install mcp httpx

在您的 AI 助手中配置 MCP 服务器：

在 Claude Desktop 中

在 Claude Desktop 配置中添加以下内容：

{
  "mcpServers": {
    "weather": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/weather",
        "run",
        "weather.py"
      ]
    }
  }
}

在 Cursor 中

前往 Cursor 设置 -> MCP 服务器 -> 添加 MCP 服务器

名称：天气（或其他您喜欢的名称）
类型：命令
命令：uv run /ABSOLUTE/PATH/TO/PARENT/FOLDER/weather/weather.py

💻 使用示例

一旦 MCP 服务器设置完成，您可以要求 AI 助手：

"CA 现在有什么天气警报吗？"
"获取纬度 37.7749 和经度 -122.4194 的天气预报"

📄 许可证

本项目用于教育目的。

🙏 致谢

感谢 National Weather Service (NWS) 提供天气数据，MCP 文档提供实现服务器的指导。

weather-mcp-server-pyp