关键词

NOAA潮汐洋流月相日出日落

本项目是一个 Model Context Protocol (MCP) 服务器，旨在为大型语言模型 (LLM) 客户端提供访问 NOAA (美国国家海洋和大气管理局) 潮汐和洋流数据，以及日月天体信息的能力。它通过标准化的 MCP 工具接口暴露这些功能。

主要功能点

  • 潮汐与水位查询： 获取指定站点的实时、历史或预测潮汐水位数据。
  • 洋流查询： 获取指定站点的实时、历史或预测洋流数据。
  • 气象数据查询： 获取指定站点的风速、气温、水温等气象数据。
  • 站点信息： 查询 NOAA 站点的列表及详细信息。
  • 日月天体信息： 计算并查询月相、日出/日落时间及方位等信息。
  • 参数定义： 获取 NOAA API 调用中各类参数（如时区、单位、数据基准面等）的有效值信息。

安装步骤

  1. 克隆仓库： 首先，你需要将本项目的代码克隆到你的本地计算机上。 
    git clone https://github.com/RyanCardin15/NOAA-TidesAndCurrents-MCP.git
cd NOAA-TidesAndCurrents-MCP
  2. 安装依赖： 进入项目目录后，使用 npm 或 yarn 安装所需的依赖。 
    npm install
# 或者 yarn install
  3. 构建项目： 项目使用 TypeScript 编写，需要先进行构建编译。 
    npm run build
    构建成功后，会在 'dist' 目录下生成可执行的 JavaScript 文件。

MCP 服务器配置（供MCP客户端使用）

本 MCP 服务器使用 Stdio 传输协议进行通信。要将此服务器添加到支持 MCP 的客户端（如某些 LLM 桌面应用），通常需要提供服务器的启动信息。

通常你需要客户端配置以下信息来启动和连接此服务器：

  • 服务器名称 (name): 'LocalTides'
  • 启动命令 (command): 'node'
  • 命令参数 (args): '["dist/index.js"]'
  • 传输协议 (transport): 'stdio'

请根据你的 MCP 客户端的具体配置界面或文件格式填写这些信息。

基本使用方法

一旦服务器在你的 MCP 客户端中正确配置并启动，LLM 将能够发现并调用此服务器提供的工具。你无需直接与服务器代码交互。

你可以通过向 LLM 提问来间接使用这些功能，例如：

  • "请查询纽约 Battery 站点的当前潮汐水位。" (对应 'get_water_levels' 工具)
  • "未来三天旧金山的最高潮和最低潮时间是什么时候？" (对应 'get_tide_predictions' 工具)
  • "告诉我下个月的满月是哪一天。" (对应 'get_next_moon_phase' 工具)
  • "洛杉矶今天日出和日落的时间是？" (对应 'get_sun_times' 工具)
  • "NOAA 支持哪些数据基准面 (datum)？" (对应 'get_parameter_definitions' 工具)

LLM 会根据你的问题，自动选择并调用服务器提供的相应工具来获取信息并回答你。

信息

分类

网页与API

访问项目