NOAA Tides and Currents MCP Server

NOAA Tides and Currents MCP Server

site icon
2025.03.14 0
TypeScript水文数据气象数据天文数据位置服务
NOAA Tides and Currents MCP Server 是一个基于 FastMCP 框架的 MCP(Model Context Protocol)服务器,用于与 NOAA Tides and Currents API 进行交互。该服务器提供了丰富的水文和气象数据检索功能,包括实时和历史的水位数据、潮汐预测、海流数据、气象数据、月相信息以及日出日落时间等。
View on GitHub

Overview

基本能力

产品定位

NOAA Tides and Currents MCP Server 是一个专门用于水文和气象数据检索的服务,通过 MCP 协议提供 NOAA Tides and Currents API 的访问能力。

核心功能

  • 水位数据检索(实时和历史)
  • 潮汐预测(高低潮或基于间隔)
  • 海流数据(实时和历史)
  • 海流预测
  • 站点元数据检索
  • 风、气温、水温和其他气象数据
  • 月相信息(过去、现在和未来)
  • 日出日落和位置数据(过去、现在和未来)

适用场景

  • 海洋科学研究
  • 航海和渔业活动规划
  • 气象预报和分析
  • 天文观测和摄影
  • 环境监测和评估

工具列表

  1. Water Levels
  2. get_water_levels:获取站点水位数据
  3. Tide Predictions
  4. get_tide_predictions:获取潮汐预测数据
  5. Currents
  6. get_currents:获取站点海流数据
  7. Current Predictions
  8. get_current_predictions:获取海流预测数据
  9. Meteorological Data
  10. get_meteorological_data:获取气象数据
  11. Station Information
  12. get_stations:获取站点列表
  13. get_station_details:获取站点详细信息
  14. Moon Phase Information
  15. get_moon_phase:获取特定日期的月相信息
  16. get_moon_phases_range:获取日期范围内的月相信息
  17. get_next_moon_phase:获取下一个特定月相的出现时间
  18. Sun Rise/Set Information
  19. get_sun_times:获取特定日期和位置的日出日落时间
  20. get_sun_times_range:获取日期范围内的日出日落时间
  21. get_sun_position:获取特定日期、时间和位置的太阳位置信息
  22. get_next_sun_event:获取下一个特定太阳事件的出现时间

常见问题解答

  • 如何获取实时水位数据?使用 get_water_levels 工具,设置 date 参数为 "latest"。
  • 如何获取未来一周的潮汐预测?使用 get_tide_predictions 工具,设置 begin_dateend_date 参数为相应的日期。

使用教程

使用依赖

  • Node.js (v18 或更高版本)
  • npm 或 yarn

安装教程

通过 Smithery 安装

npx -y @smithery/cli install @RyanCardin15/tidesandcurrents --client claude

手动安装

  1. 克隆仓库
  2. 安装依赖
npm install
  1. 创建 .env 文件
# Server Configuration
PORT=3000

# Transport type (stdio or sse)
TRANSPORT_TYPE=stdio

# NOAA API application name for identification (recommended)
APPLICATION_NAME=YourAppName
  1. 构建 TypeScript 代码
npm run build
  1. 启动服务器
npm start

调试方式

使用 fastmcp 命令行工具进行测试:

npx fastmcp dev dist/index.js

或使用 MCP Inspector:

npx fastmcp inspect dist/index.js

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。