使用说明

项目简介

本项目实现了一个名为 "weather" 的基础MCP服务器，提供了两个工具：'get_alerts' 用于获取美国州的天气警报，'get_forecast' 用于获取指定经纬度的天气预报。这些工具可以被MCP客户端调用，以获取实时的天气信息。

主要功能点

基于 'fastmcp' 库实现MCP协议。
提供 'get_alerts' 工具：根据美国州份代码获取天气警报信息。
提供 'get_forecast' 工具：根据经纬度坐标获取天气预报信息。
使用 Stdio 传输协议与客户端通信。

安装步骤

本项目无需复杂的安装步骤，'weather.py' 文件包含了服务器的全部代码。

环境依赖：

Python 3.7 或更高版本
依赖库：'mcp-server', 'httpx' (虽然在提供的仓库内容中没有明确列出安装步骤，但根据代码推断，需要安装这些库)

您可以使用 pip 安装依赖：

pip install mcp-server httpx

服务器配置

以下 JSON 配置信息用于 MCP 客户端连接到 Weather MCP Server。

{
  "server_name": "weather",  //  MCP 服务器名称，需与 weather.py 中 FastMCP(name="weather") 定义的名称一致
  "command": "python",      //  启动服务器的命令，这里使用 python 解释器
  "args": ["MCP/weather/weather.py"] // 启动命令的参数，指向 weather.py 脚本的路径
}

'server_name': MCP 服务器的名称，必须与 'weather.py' 文件中 'FastMCP(name="weather")' 初始化的名称 '"weather"' 一致。
'command': 用于启动服务器的命令。由于服务器是 Python 脚本，这里设置为 'python'。
'args': 启动命令的参数，是一个字符串数组。这里指定了 'weather.py' 脚本的相对路径，指向服务器主程序文件。

基本使用方法

启动服务器: 在终端中，导航到仓库的根目录，并执行以下命令来启动 Weather MCP Server：
```
python MCP/weather/weather.py
```
服务器将通过 Stdio 协议运行，并等待客户端连接和请求。
配置 MCP 客户端: 在您的 MCP 客户端应用中，配置连接到 Weather MCP Server。您需要提供上面 服务器配置 中生成的 JSON 信息。客户端将使用这些配置信息来建立与服务器的连接。
调用工具: 一旦客户端成功连接到服务器，您就可以通过客户端调用服务器提供的工具，例如 'get_alerts' 和 'get_forecast'。
- 调用 'get_alerts' 工具时，需要提供 'state' 参数（美国州份代码，例如 "WA"）。服务器将返回该州的天气警报信息。
- 调用 'get_forecast' 工具时，需要提供 'latitude' 和 'longitude' 参数（经纬度坐标）。服务器将返回该位置的天气预报信息。

请参考 MCP 客户端的文档，了解如何配置服务器连接以及如何调用和使用工具。

关键词