使用说明

项目简介

'Revvy Weather Tools Server' 是 Revvy Discord AI 机器人项目的一部分，它是一个基于 Model Context Protocol (MCP) 构建的后端服务器，专门提供天气信息相关的工具。该服务器旨在通过标准化的 MCP 协议，向 Revvy 或其他兼容的 LLM 客户端提供天气查询能力，增强 AI 应用的上下文感知和功能性。

主要功能点

提供天气警报查询工具: 允许 LLM 客户端查询日本特定县（prefecture）的天气警报信息。
提供天气预报查询工具: 允许 LLM 客户端查询指定经纬度位置的天气预报信息。
基于 MCP 协议: 使用 JSON-RPC over Stdio 与客户端通信，实现工具的注册和调用。
易于集成: 可以与任何支持 MCP 客户端的 LLM 应用集成，扩展其天气信息处理能力。

安装步骤

由于 'Revvy Weather Tools Server' 是 Revvy 项目的一部分，其安装通常与 Revvy 项目的整体部署流程一致。简要步骤如下 (更详细的安装步骤请参考 Revvy 项目的完整文档)：

环境准备: 确保已安装 Python 3.7+ 和 Poetry 依赖管理工具。

获取代码: 从 GitHub 克隆 Revvy 仓库 (如果您尚未克隆):

git clone https://github.com/chiyonn/revvy
cd revvy

安装依赖: 使用 Poetry 安装项目依赖，包括 'mcp' 库:
```
poetry install
```

服务器配置

对于 MCP 客户端（例如 'discord/llm_client.py'），需要配置连接 'Revvy Weather Tools Server' 的信息。以下是配置示例，通常在客户端代码中指定：

{
  "serverName": "weather",
  "command": "poetry",
  "args": ["run", "mcp/weather.py"],
  "transport": "stdio"
}

配置参数说明:

'serverName': 服务器名称，这里设置为 "weather" (来自 'FastMCP("weather")')，用于客户端识别。
'command': 启动服务器的命令，这里使用 'poetry run' 来执行 'mcp/weather.py' 脚本。
'args': 传递给启动命令的参数，'["run", "mcp/weather.py"]' 表示使用 Poetry 运行 'mcp/weather.py' 文件。
'transport': 传输协议，这里使用 "stdio" 表示标准输入输出管道。

基本使用方法

启动 MCP 服务器: 在 Revvy 项目根目录下，使用 Poetry 运行 'discord/mcp/weather.py' 脚本，启动天气工具 MCP 服务器 (通常 Revvy 项目会自动化启动此服务器)。
```
poetry run python discord/mcp/weather.py
```
(实际上，客户端配置中已经指定了启动命令，客户端会自动启动服务器，用户通常无需手动启动)
配置 MCP 客户端: 确保您的 MCP 客户端（如 'discord/llm_client.py'）已正确配置上述服务器连接信息。
使用天气工具: 当 LLM 客户端接收到需要天气信息的用户请求时，它将根据 Prompt 模板和工具调用机制，自动调用 'Revvy Weather Tools Server' 提供的 'get_alerts' 或 'get_forecast' 工具，并将结果返回给用户。用户无需直接与 MCP 服务器交互，而是通过与集成了 MCP 客户端的 LLM 应用（例如 Revvy Discord 机器人）交互来间接使用天气工具。

注意: 'Revvy Weather Tools Server' 旨在与 MCP 客户端协同工作，本身不提供用户直接交互界面。用户通过 Revvy Discord 机器人等 MCP 客户端应用来体验其功能。

关键词

使用说明

信息