使用说明

项目简介

本项目是一个基于Node.js开发的MCP (Model Context Protocol) 服务器示例,旨在演示如何构建一个能够为大型语言模型(LLM)客户端提供天气信息服务的后端应用。它提供了两个工具:查询美国州的天气预警和查询美国特定地点的天气预报。

主要功能点

  • 获取美国天气预警 (get-alerts): 允许LLM客户端查询指定美国州(例如:CA, NY)的当前天气预警信息。
  • 获取美国天气预报 (get-forecast): 允许LLM客户端查询美国特定经纬度坐标的天气预报信息。

安装步骤

由于本项目已发布为 npm 包,因此无需手动安装,可以直接通过 'npx' 命令运行。

服务器配置

要将此 MCP 服务器与 MCP 客户端(例如 Claude Desktop)配合使用,您需要配置客户端以连接到此服务器。以下是 Claude Desktop 的配置示例,您需要将以下 JSON 片段合并到您的 'claude_desktop_config.json' 文件中。

{
  "mcpServers": {
    "weather": {
      "command": "npx",
        "args": [
            "-y",
            "@h1deya/mcp-server-weather"
        ],
    }
  }
}

配置参数说明:

  • 'server name': 'weather' (您可以自定义服务器名称,用于在客户端配置中识别此服务器)
  • 'command': 'npx' (运行服务器的命令。 'npx' 用于直接执行 npm 包)
  • 'args': '["-y", "@h1deya/mcp-server-weather"]' (传递给 'npx' 命令的参数。 '-y' 表示自动确认安装 npm 包,'@h1deya/mcp-server-weather' 是包含服务器代码的 npm 包名称)

基本使用方法

  1. 确保您的 MCP 客户端(例如 Claude Desktop)已正确配置上述服务器信息。
  2. 启动 MCP 客户端。客户端将自动连接到此 MCP 服务器。
  3. 在 MCP 客户端中,您可以向 LLM 提出与天气相关的问题,例如:
    • "加州的天气预警有哪些?"
    • "明天帕洛阿托的天气怎么样?"
    • "纽约今天会下雨吗?"
  4. LLM 客户端将识别到需要调用天气信息,并使用配置的 "weather" MCP 服务器来获取信息并生成回答。

注意: 此服务器依赖于美国国家气象局 (NWS) API,因此仅能查询美国地区的天气信息。

信息

分类

网页与API