关键词

天气预报开放API地理位置工具服务函数调用

使用说明

项目简介

本项目是一个实现了 Model Context Protocol (MCP) 的服务器，专注于提供天气预报功能。它通过公开一个名为 'get_weather_forecast' 的工具，使 LLM 客户端能够查询特定地点和日期的天气预报信息。

主要功能点

  • 提供天气预报工具: 服务器核心功能是 'get_weather_forecast' 工具，该工具接受地点和日期作为输入，返回该地点的天气预报。
  • 基于开放API: 天气数据来源于 Open-Meteo API，地理编码使用 OpenStreetMap，确保数据准确性。
  • 标准 MCP 协议: 完全遵循 MCP 协议，易于与任何兼容 MCP 协议的 LLM 客户端集成。
  • 易于部署和运行: 通过 'npx' 命令即可快速启动服务器，无需复杂的配置。

安装步骤

  1. 确保已安装 Node.js 和 npm。
  2. 打开终端，运行以下命令即可下载并启动服务器： 
    npx -y @philschmid/weather-mcp
    服务器将通过标准输入/输出 (stdio) 接口等待客户端连接。

服务器配置

对于 MCP 客户端，需要配置以下服务器连接信息以连接到天气预报 MCP 服务器。配置信息为 JSON 格式，通常在客户端的服务器参数设置中使用。

{
  "server_name": "Weather MCP",
  "command": "npx",
  "args": [
    "-y",
    "@philschmid/weather-mcp"
  ],
  "transport": "stdio"
}

配置参数说明:

  • 'server_name': 服务器的名称，这里设置为 "Weather MCP"。
  • 'command': 启动服务器的命令，这里使用 'npx'，用于执行 npm 包。
  • 'args': 传递给 'npx' 命令的参数，'"-y", "@philschmid/weather-mcp"' 表示运行 '@philschmid/weather-mcp' 包，'-y' 参数用于自动确认安装包。
  • 'transport': 指定传输协议，这里使用 'stdio'，表示通过标准输入/输出进行通信。

基本使用方法

  1. 启动服务器: 按照安装步骤启动天气预报 MCP 服务器。
  2. 配置 MCP 客户端: 在您的 MCP 客户端中，配置上述服务器连接信息。
  3. 调用工具: 在 LLM 交互中，当需要查询天气信息时，LLM 客户端可以调用 'get_weather_forecast' 工具，并提供 'location'（地点，例如 "London, UK"）和 'date'（日期，例如 "2024-07-27"）作为参数。
  4. 获取天气预报: 服务器将返回 JSON 格式的天气预报数据，客户端可以解析并呈现给用户或继续进行后续处理。

示例 (Python 客户端)

仓库中提供了 Python 客户端的使用示例，展示了如何使用 'mcp' 库和 Google Gemini API 与该服务器进行交互。您可以参考该示例，了解如何在实际应用中使用此天气预报 MCP 服务器。

信息

分类

网页与API

访问项目