Noaa Tides Currents MCP Server

🌊 NOAA潮流MCP服务器

](https://www.npmjs.com/package/@ryancardin/noaa-tides-currents-mcp-server)   

](https://smithery.ai/server/@RyanCardin15/noaa-tidesandcurrents-mcp)

🚀 通过MCP闪电般快速访问NOAA的海洋和大气数据

*潮汐、洋流、天气、天文和气候数据的一站式解决方案*

📦 快速开始 • 🛠️ 工具 • 📖 例子 • 🏗️ 高级

______________________________________________________________________

✨ 是什么让这太棒了

🌊 25+专用工具 -从基本潮汐数据到高级气候预测\ ⚡ 迅速的 -基于FastMCP构建，实现最佳性能\ 🎯 零配置 -与Claude Desktop一起开箱即用\ 🌍 综合数据 -水位、洋流、天气、月相、太阳数据\ 📊 气候研究准备就绪 -海平面趋势、洪水预测、极端事件\ 🚀 NPX就绪 -只需一个命令即可安装并运行

______________________________________________________________________

🚀 快速开始

⚡ NPX安装（推荐）

# Install and run immediately - no setup required!
npx @ryancardin/noaa-tides-currents-mcp-server

# Or use the shorter alias
npx noaa-mcp

🔌 运输方式

STDIO模式（默认-MCP协议）

# Standard MCP server for Claude Desktop integration
npx @ryancardin/noaa-tides-currents-mcp-server

# Or use the shorter alias
npx noaa-mcp

HTTP流模式（Web集成）

# Start HTTP server on default port 3000
npx @ryancardin/noaa-tides-currents-mcp-server --http

# Specify custom port
npx @ryancardin/noaa-tides-currents-mcp-server --http --port 8080

# Using shorter alias
npx noaa-mcp --http --port 8080

# Access via Server-Sent Events
curl http://localhost:3000/sse

🎯 Claude桌面集成

通过以下方式直接安装到Claude Desktop 史密瑟里:

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

🔧 手动开发设置

# Clone and build
git clone https://github.com/RyanCardin15/NOAA-Tides-And-Currents-MCP.git
cd NOAA-Tides-And-Currents-MCP
npm install && npm run build

# Start the server
npm start

# Test with FastMCP
npx fastmcp dev dist/index.js

______________________________________________________________________

🛠️ 可用工具

🌊 Water Data Tools (6 tools)

水位和潮汐

• get_water_levels -实时和历史水位数据
• get_tide_predictions -高潮/低潮预测和连续数据
• get_currents -实时和历史电流测量
• get_current_predictions -当前速度和方向预测
• get_meteorological_data -风、气温、水温、压力等。

车站信息

• get_stations -搜索并列出监测站
• get_station_details -详细的台站元数据和能力

🔬 Climate & Research Tools (9 tools)

海平面分析

• get_sea_level_trends -长期海平面上升趋势和速度
• get_extreme_water_levels -极端事件的统计分析

涨潮洪水分析

• get_high_tide_flooding_daily -每日洪水事件计数
• get_high_tide_flooding_monthly -月度洪水模式
• get_high_tide_flooding_seasonal -季节性洪水分析
• get_high_tide_flooding_annual -年度洪水趋势
• get_high_tide_flooding_projections -未来洪水风险情景
• get_high_tide_flooding_likelihoods -日洪水概率

历史极端

• get_top_ten_water_levels -有记录以来的最高/最低水位

🌙 Astronomy Tools (7 tools)

月相计算

• get_moon_phase -当前月相和照度
• get_moon_phases_range -日期范围内的月相
• get_next_moon_phase -查找下一个新月/满月/四分之一月

太阳能计算

• get_sun_times -日出、日落、黎明、黄昏
• get_sun_times_range -日期范围内的太阳时间
• get_sun_position -实时太阳方位角和仰角
• get_next_sun_event -下一个日出、日落或正午

⚙️ Configuration Tools (1 tool)

API参数

• get_parameter_definitions -所有API参数的有效值

______________________________________________________________________

📖 使用示例

🌊 获取当前潮汐状况

# Get latest water levels for Boston Harbor
get_water_levels station="8443970" date="latest"

# Get today's tide predictions for Miami
get_tide_predictions station="8723214" begin_date="today" end_date="today" interval="hilo"

🌀 飓风防备

# Get extreme water level statistics for storm planning
get_extreme_water_levels station="8518750" units="english"

# Check flooding likelihood for tomorrow
get_high_tide_flooding_likelihoods station="8518750" date="2024-12-16" threshold="minor"

🔬 气候研究

# Analyze 30-year sea level trends
get_sea_level_trends station="8518750" affiliation="US"

# Get high tide flooding projections for 2050s under intermediate sea level rise
get_high_tide_flooding_projections station="8518750" scenario="intermediate" decade="2050s"

🌙 天文学与航海

# Get tonight's moon phase for navigation
get_moon_phase date="2024-12-15" latitude="42.3601" longitude="-71.0589"

# Calculate sunrise/sunset for sailing
get_sun_times date="2024-12-15" latitude="25.7617" longitude="-80.1918" timezone="America/New_York"

🎣 钓鱼与娱乐

# Best fishing times with current predictions
get_current_predictions station="ACT0446" date="today" interval="MAX_SLACK"

# Wind and weather conditions
get_meteorological_data station="8443970" product="wind" date="today"

______________________________________________________________________

🏗️ 高级用法

🔧 开发与测试

# Run in development mode (stdio)
npm run dev

# Development with HTTP transport
npm run dev:http

# Production builds with different transports
npm start                    # STDIO mode (default)
npm run start:http          # HTTP on port 3000
npm run start:http:3001     # HTTP on port 3001
npm run start:http:8080     # HTTP on port 8080

# Inspect server capabilities
npx fastmcp inspect dist/index.js

🌐 HTTP流集成

在HTTP模式下运行时，服务器在以下位置提供服务器发送事件（SSE） /sse:

# Start HTTP server
npx @ryancardin/noaa-tides-currents-mcp-server --http --port 3000

# Test the endpoint
curl -N http://localhost:3000/sse

# Or integrate with web applications
fetch('http://localhost:3000/sse')
  .then(response => response.body.getReader())
  .then(reader => {
    // Handle streaming MCP responses
  });

HTTP模式的用例：

• 🌐 Web应用程序 -与React、Vue、Angular应用程序集成
• 📱 移动应用 -从移动应用程序进行类似REST的访问
• 🔗 API网关 -通过负载平衡器或API网关进行代理
• 🧪 测试 -易于基于curl的测试和调试

📊 数据格式和导出

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

• 对象符号 （默认）-非常适合程序化使用
• 可扩展置标语言 -遗留系统集成
• CSV文件 -直接导入电子表格

🌍 全球电台覆盖范围

• 13000+个车站 全球
• 实时数据 来自美国国家海洋和大气管理局的CO-OPS网络
• 历史记录 可以追溯到几十年前
• 全球潮汐预测 以及当前的预测

______________________________________________________________________

🚦 API终点

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

______________________________________________________________________

🛠️ 技术细节

建筑

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

运输选项

• 📡 STDIO传输 -桌面客户端的标准MCP协议
• 🌐 HTTP流传输 -web集成的服务器发送事件
• 🔄 双模式支持 -通过命令行标志在传输之间切换

系统要求

• Node.js 18+
• NPM 8+
• MCP客户端 （克劳德桌面等）

包装尺寸

• 📦 捆绑的：43.9 KB
• 📂 已安装：286.2 KB
• ⚡ 加载时间：\

Common Issues & Solutions

服务器无法启动

# Check Node.js version
node --version  # Should be 18+

# Rebuild TypeScript
npm run build

API错误

• 站ID无效：使用 get_stations 查找有效站点
• 日期格式问题：使用YYYYMMDD或MM/DD/YYYY格式
• 速率限制：NOAA API有使用限制-空格请求

MCP连接问题

• 确保正确配置了Claude Desktop MCP设置
• 检查服务器二进制文件是否具有执行权限： chmod +x dist/index.js

______________________________________________________________________

📈 路线图

• \[ \] 🌊 实时警报 -Webhook支持潮汐/天气警报
• \[ \] 📱 移动SDK -React Native集成
• \[ \] 🗺️ GIS集成 -Shapefile和KML导出
• \[ \] 🤖 AI洞察 -自动模式识别
• \[ \] ⚡ GraphQL API -现代查询界面
• \[ \] 🌐 多语言 -I18n支持

______________________________________________________________________

🤝 贡献

我们热爱贡献！以下是如何开始：

1. 🍴 分叉 存储库
2. 🌿 分支 为您的功能(git checkout -b amazing-feature)
3. 💻 代码 您的改进
4. ✅ 测试 随着 npm test
5. 📤 提交 pull请求

开发命令

npm run build    # Build TypeScript
npm run dev      # Development mode  
npm run test     # Run test suite
npm run format   # Format with Prettier

______________________________________________________________________

📄 许可证

MIT许可证 -看 许可证 文件以获取详细信息。

内置于❤️ 靠近 瑞安·卡丹

______________________________________________________________________

🔗 链接和资源

• 📦 NPM包: @ryancadin/noa潮流mcp服务器
• 🏪 史密瑟里: Claude Desktop的自动安装
• 🌊 NOAA合作社: 美国国家海洋和大气管理局官方数据门户
• 🤖 MCP协议: 模型上下文协议文档
• ⚡ FastMCP: FastMCP框架

⭐ 如果这个回购对你有帮助，请加星！

得益于美国国家海洋和大气管理局对开放海洋数据的承诺🌊