NOAA TidesAndCurrents MCP

🚀 🌊 NOAA潮汐与海流MCP服务器

本项目借助MCP协议，提供对美国国家海洋和大气管理局（NOAA）海洋与大气数据的快速访问。涵盖潮汐、海流、气象、天文和气候等多方面数据，为各类需求提供一站式解决方案。

📦 快速开始 • 🛠️ 可用工具 • 📖 使用示例 • 🏗️ 高级用法

✨ 主要特性

• 🌊 25+专业工具：涵盖从基础潮汐数据到高级气候预测等多种功能。
• ⚡ 极速响应：基于FastMCP构建，性能卓越。
• 🎯 零配置：可直接与Claude Desktop配合使用。
• 🌍 全面数据：包含水位、海流、气象、月相、太阳数据等。
• 📊 适用于气候研究：提供海平面趋势、洪水预测、极端事件等数据。
• 🚀 支持NPX：通过单条命令即可安装和运行。

🚀 快速开始

⚡ NPX安装（推荐）

# 立即安装并运行，无需设置！
npx @ryancardin/noaa-tides-currents-mcp-server

# 或使用更短的别名
npx noaa-mcp

🔌 传输模式

标准输入输出模式（默认 - MCP协议）

# 用于Claude Desktop集成的标准MCP服务器
npx @ryancardin/noaa-tides-currents-mcp-server

# 或使用更短的别名
npx noaa-mcp

HTTP流式模式（用于Web集成）

# 在默认端口3000上启动HTTP服务器
npx @ryancardin/noaa-tides-currents-mcp-server --http

# 指定自定义端口
npx @ryancardin/noaa-tides-currents-mcp-server --http --port 8080

# 使用更短的别名
npx noaa-mcp --http --port 8080

# 通过服务器发送事件访问
curl http://localhost:3000/sse

🎯 与Claude Desktop集成

通过Smithery直接安装到Claude Desktop：

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

🔧 手动开发设置

# 克隆并构建
git clone https://github.com/RyanCardin15/NOAA-Tides-And-Currents-MCP.git
cd NOAA-Tides-And-Currents-MCP
npm install && npm run build

# 启动服务器
npm start

# 使用FastMCP进行测试
npx fastmcp dev dist/index.js

🛠️ 可用工具

💻 使用示例

🌊 获取当前潮汐状况

# 获取波士顿港的最新水位
get_water_levels station="8443970" date="latest"

# 获取迈阿密今天的潮汐预测
get_tide_predictions station="8723214" begin_date="today" end_date="today" interval="hilo"

🌀 飓风准备

# 获取极端水位统计数据，用于风暴规划
get_extreme_water_levels station="8518750" units="english"

# 检查明天的洪水可能性
get_high_tide_flooding_likelihoods station="8518750" date="2024-12-16" threshold="minor"

🔬 气候研究

# 分析30年的海平面趋势
get_sea_level_trends station="8518750" affiliation="US"

# 获取2050年代中等海平面上升情景下的高潮洪水预测
get_high_tide_flooding_projections station="8518750" scenario="intermediate" decade="2050s"

🌙 天文与导航

# 获取今晚用于导航的月相
get_moon_phase date="2024-12-15" latitude="42.3601" longitude="-71.0589"

# 计算帆船航行的日出/日落时间
get_sun_times date="2024-12-15" latitude="25.7617" longitude="-80.1918" timezone="America/New_York"

🎣 钓鱼与休闲

# 根据当前预测获取最佳钓鱼时间
get_current_predictions station="ACT0446" date="today" interval="MAX_SLACK"

# 获取风和气象条件
get_meteorological_data station="8443970" product="wind" date="today"

🏗️ 高级用法

🔧 开发与测试

# 在开发模式下运行（标准输入输出）
npm run dev

# 使用HTTP传输进行开发
npm run dev:http

# 使用不同传输方式进行生产构建
npm start                    # 标准输入输出模式（默认）
npm run start:http          # 在端口3000上使用HTTP
npm run start:http:3001     # 在端口3001上使用HTTP
npm run start:http:8080     # 在端口8080上使用HTTP

# 检查服务器功能
npx fastmcp inspect dist/index.js

🌐 HTTP流集成

当以HTTP模式运行时，服务器在 /sse 提供服务器发送事件（SSE）：

# 启动HTTP服务器
npx @ryancardin/noaa-tides-currents-mcp-server --http --port 3000

# 测试端点
curl -N http://localhost:3000/sse

# 或与Web应用程序集成
fetch('http://localhost:3000/sse')
  .then(response => response.body.getReader())
  .then(reader => {
    // 处理流式MCP响应
  });

HTTP模式的使用场景：

• 🌐 Web应用程序：与React、Vue、Angular应用集成。
• 📱 移动应用程序：从移动应用进行类似REST的访问。
• 🔗 API网关：通过负载均衡器或API网关进行代理。
• 🧪 测试：通过简单的curl命令进行测试和调试。

📊 数据格式与导出

所有工具支持多种输出格式：

• JSON（默认）：非常适合编程使用。
• XML：用于与旧系统集成。
• CSV：可直接导入电子表格。

🌍 全球站点覆盖

• 13,000+个站点：遍布全球。
• 实时数据：来自NOAA的CO - OPS网络。
• 历史记录：可追溯到数十年前。
• 全球潮汐预测和海流预报。

🚦 API端点

该服务器与三个NOAA API集成：

🔧 技术细节

架构

• 🚀 FastMCP框架：高性能MCP服务器。
• 📝 TypeScript：提供完整的类型安全和智能感知。
• 🔧 Zod验证：运行时参数验证。
• ⚡ Axios HTTP客户端：可靠的API通信。
• 🌙 SunCalc集成：精确的天文计算。

传输选项

• 📡 标准输入输出传输：适用于桌面客户端的标准MCP协议。
• 🌐 HTTP流传输：用于Web集成的服务器发送事件。
• 🔄 双模式支持：通过命令行标志在传输方式之间切换。

系统要求

• Node.js 18+
• NPM 8+
• MCP客户端（Claude Desktop等）

包大小

• 📦 打包后：43.9 KB
• 📂 安装后：286.2 KB
• ⚡ 加载时间：<100ms

🐛 故障排除

# 检查Node.js版本
node --version  # 应为18+

# 重新构建TypeScript
npm run build

📈 路线图

• [ ] 🌊 实时警报：支持潮汐/气象警报的Webhook。
• [ ] 📱 移动SDK：集成React Native。
• [ ] 🗺️ GIS集成：支持Shapefile和KML导出。
• [ ] 🤖 AI洞察：自动化模式识别。
• [ ] ⚡ GraphQL API：现代查询接口。
• [ ] 🌐 多语言支持：支持国际化。

🤝 贡献

我们欢迎贡献！以下是开始的步骤：

1. 🍴 分叉 仓库。
2. 🌿 创建分支 用于你的功能（git checkout -b amazing-feature）。
3. 💻 编写代码 实现你的改进。
4. ✅ 测试 使用 npm test。
5. 📤 提交 拉取请求。

开发命令

npm run build    # 构建TypeScript
npm run dev      # 开发模式
npm run test     # 运行测试套件
npm run format   # 使用Prettier格式化代码

📄 许可证

MIT许可证 - 详情请参阅 LICENSE 文件。

由 Ryan Cardin 用心打造

🔗 链接与资源

• 📦 NPM包：@ryancardin/noaa-tides-currents-mcp-server
• 🏪 Smithery：自动安装到Claude Desktop
• 🌊 NOAA CO - OPS：官方NOAA数据门户
• 🤖 MCP协议：模型上下文协议文档
• ⚡ FastMCP：FastMCP框架