使用说明

项目简介

Open-Meteo Weather MCP服务器是一个基于Model Context Protocol (MCP) 的后端服务，它利用 Open-Meteo API 提供天气查询功能。该服务器通过定义和注册工具，使得LLM客户端能够调用这些工具来获取特定城市的天气信息。

主要功能点

提供天气查询工具: 通过 'get_weather' 工具，可以查询指定城市当前的温度、风速和天气状况。
简单的测试工具: 包含 'test_echo' 工具，用于验证服务器是否正常运行。
基于 FastMCP 框架: 使用 'fastmcp' 库简化 MCP 服务器的开发和部署。

安装步骤

环境准备: 确保已安装 Python 3.7 或更高版本。

安装依赖: 使用 pip 安装必要的 Python 库：

pip install fastmcp aiohttp

下载代码: 从 GitHub 仓库 'https://github.com/dennj/weather-mcp' 下载 'mcp_weather.py' 文件。

服务器配置

MCP 客户端需要配置以下 JSON 格式信息以连接到 Open-Meteo Weather MCP 服务器。请注意，以下配置假设 'mcp_weather.py' 文件位于 MCP 客户端可以访问的路径中。

{
  "serverName": "WeatherService",  // MCP 服务器名称，与代码中 FastMCP 初始化时名称一致
  "command": "python",         // 启动服务器的命令，这里使用 python 解释器
  "args": ["/path/to/mcp_weather.py"] // 启动参数，指向 mcp_weather.py 脚本的路径，请替换为实际路径
}

参数注释:

'serverName': 定义了 MCP 服务器的名称，必须与 'mcp_weather.py' 代码中 'FastMCP("WeatherService")' 初始化时提供的名称 '"WeatherService"' 一致。客户端通过此名称识别和连接服务器。
'command': 指定用于启动 MCP 服务器进程的命令。在此例中，由于服务器是 Python 脚本，所以使用 'python' 命令来执行。
'args': 一个字符串数组，包含了传递给启动命令的参数。这里，我们传递了 'mcp_weather.py' 脚本的绝对路径 '/path/to/mcp_weather.py' 作为参数，告知 'python' 命令需要执行哪个脚本。请务必将 '/path/to/mcp_weather.py' 替换为 'mcp_weather.py' 文件在您本地文件系统中的实际路径。 例如，如果 'mcp_weather.py' 文件位于 '/home/user/mcp_weather.py'，则应配置为 '["/home/user/mcp_weather.py"]'。

基本使用方法

启动 MCP 服务器: 在安装好依赖并配置好 MCP 客户端后，启动 MCP 服务器。服务器将会在后台运行，等待 MCP 客户端的连接和请求。
客户端调用工具: 在 MCP 客户端中，可以使用以下工具与服务器交互：
- 'test_echo': 调用此工具会返回一个简单的欢迎消息，用于测试服务器连接和工具调用是否正常。
- 'get_weather': 调用此工具并提供城市名称作为参数，例如 '{"city": "London"}'，服务器将返回该城市当前的天气信息，包括温度、风速和天气状况代码。

注意: 此 MCP 服务器依赖于 Open-Meteo API，请确保网络连接正常以便服务器能够访问 Open-Meteo API 获取天气数据。

关键词