AI导哈

天气数据查询工具

一个基于MCP协议和Google Gemini AI的命令行工具，提供美国天气数据的查询功能，支持自然语言交互。

  • by Abhinavexists
  • Python
  • 本地部署
  • 9 星标
  • 更新于
在 GitHub 查看 Abhinavexists/MCP_Server

使用说明

主控程序

命令行工具的简单实现，该工具使用模型上下文协议（MCP）和谷歌的Gemini AI通过客户端-服务器架构提供对美国天气数据的访问。 旨在实践和理解MCP的工作原理。

概述

该项目将Python客户端应用程序与天气数据服务器连接起来，允许用户使用自然语言查询天气信息。服务器与美国国家气象局API通信以检索天气警报和预报。

特性

  • 使用州代码查询美国各州的天气警报
  • 使用纬度和经度获取特定地点的详细天气预报
  • 由谷歌Gemini AI驱动的自然语言界面
  • 使用模型上下文协议（MCP）的客户端-服务器架构

先决条件

  • Python 3.8+
  • Node.js（如果运行JavaScript服务器）
  • Google Gemini API密钥

安装

  1. 克隆存储库：

    git clone https://github.com/Abhinavexists/MCP_Server.git
cd weather-tool

  2. 如果你还没有安装uv：

    pip install uv

  3. 创建并激活虚拟环境：

    uv venv
    • 在Windows上： .venv\Scripts\activate
    • 在macOS/Linux上： source .venv/bin/activate

  4. 使用uv安装依赖项（此项目使用uv.lock和pyproject.toml）：

    uv pip sync

  5. 创建一个 .env 使用Gemini API密钥在项目根目录中的文件：

    GEMINI_API_KEY=your_gemini_api_key_here

用法

  1. 启动客户端并连接到天气服务器：

    python client.py server.py

  2. 连接后，您可以询问有关天气信息的问题：

    Query: What are the current weather alerts in CA?
Query: What's the forecast for latitude 37.7749, longitude -122.4194?

  3. 类型 quit 退出应用程序。

可用工具

服务器提供以下工具：

  • 获取警报：获取指定美国州的天气警报（使用两个字母的州代码）
  • 获取预测：检索特定位置的天气预报（使用纬度和经度）

项目结构

  • client.py：连接到服务器并使用Gemini AI处理用户查询的MCP客户端
  • server.py：MCP服务器，用于实现天气数据工具并与美国国家气象局API通信

错误处理

该应用程序包括强大的错误处理功能，用于：

  • 服务器脚本路径无效
  • 与NWS API的连接问题
  • API响应中的数据无效或丢失

未来改进

  • 添加其他天气数据端点
  • 对频繁请求的数据实施缓存
  • 添加对位置名称查找的支持（而不是要求lat/long）
  • 创建web界面

许可证

MIT许可证

资源

有关模型上下文协议（MCP）的更多信息，请参阅Claude MCP官方文档：

相关 MCP