Ocean MCP

海洋MCP

用于海洋和沿海数据工作流程的可独立安装的MCP服务器的单一仓库。

  

服务器

不需要API密钥 --所有服务器都使用免费的、公开可用的数据集。

快速开始

从PyPI安装

# uvx (recommended) — runs without permanent install, like npx for Python
uvx coops-mcp

# pip — install into current environment
pip install coops-mcp

# pipx — install in isolated environment with CLI entry point
pipx install coops-mcp

替换 coops-mcp 对于任何服务器： erddap-mcp, nhc-mcp, recon-mcp, stofs-mcp, ofs-mcp, rtofs-mcp, ww3-mcp.

从源码安装

git clone https://github.com/mansurjisan/ocean-mcp.git
cd ocean-mcp/servers/coops-mcp  # or erddap-mcp, nhc-mcp, recon-mcp, stofs-mcp, ofs-mcp, rtofs-mcp, ww3-mcp
uv sync

配置您的MCP客户端

添加到您的MCP设置中（例如，项目 .mcp.json):

使用PyPI软件包（推荐）：

{
  "mcpServers": {
    "coops": {
      "command": "uvx",
      "args": ["coops-mcp"]
    },
    "erddap": {
      "command": "uvx",
      "args": ["erddap-mcp"]
    },
    "nhc": {
      "command": "uvx",
      "args": ["nhc-mcp"]
    },
    "recon": {
      "command": "uvx",
      "args": ["recon-mcp"]
    },
    "stofs": {
      "command": "uvx",
      "args": ["stofs-mcp"]
    },
    "ofs": {
      "command": "uvx",
      "args": ["ofs-mcp"]
    },
    "rtofs": {
      "command": "uvx",
      "args": ["rtofs-mcp"]
    },
    "ww3": {
      "command": "uvx",
      "args": ["ww3-mcp"]
    }
  }
}

Using local source checkout

{
  "mcpServers": {
    "coops": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/ocean-mcp/servers/coops-mcp", "python", "-m", "coops_mcp"]
    },
    "erddap": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/ocean-mcp/servers/erddap-mcp", "python", "-m", "erddap_mcp"]
    },
    "nhc": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/ocean-mcp/servers/nhc-mcp", "python", "-m", "nhc_mcp"]
    },
    "recon": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/ocean-mcp/servers/recon-mcp", "python", "-m", "recon_mcp"]
    },
    "stofs": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/ocean-mcp/servers/stofs-mcp", "python", "-m", "stofs_mcp"]
    },
    "ofs": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/ocean-mcp/servers/ofs-mcp", "python", "-m", "ofs_mcp"]
    },
    "rtofs": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/ocean-mcp/servers/rtofs-mcp", "python", "-m", "rtofs_mcp"]
    },
    "ww3": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/ocean-mcp/servers/ww3-mcp", "python", "-m", "ww3_mcp"]
    }
  }
}

查询示例

配置好服务器后，您可以自然地询问您的AI助手：

CO-OPS查询：

• “获取纽约巴特利的当前水位”
• “查找迈阿密海滩附近的潮汐站”
• 南卡罗来纳州查尔斯顿的洪水统计数据是什么
• “让我看看旧金山的海平面趋势”

ERDDAP查询：

• “在CoastWatch上搜索海面温度数据集”
• “获取2024年1月加利福尼亚海岸的叶绿素数据”
• “哪些ERDDAP服务器覆盖美国东海岸？”
• “列出IOOS Gliders ERDDAP上的所有滑翔机数据集”

NHC查询：

• “现在有活跃的热带气旋吗？”
• “给我看看卡特里娜飓风的轨迹”
• “搜索大西洋5级飓风”
• “活跃风暴的预报轨迹是什么？”

Recon查询：

• “列出2024年大西洋季节HDOB侦察飞行”
• “从2024年10月7日开始获取HDOB飞行高度观测”
• “给我看看飓风米尔顿的漩涡数据信息”
• “获取AL14 2024风暴ATCF飞机修复数据”

STOFS查询：

• “获取纽约巴特利的STOFS水位预报”
• “比较过去24小时波士顿的STOFS预报和观测结果”
• “预测水位最高的顶级站点是什么？”
• “查找新奥尔良50公里范围内的STOFS站”

OFS查询：

• “切萨皮克湾有哪些OFS模型？”
• “从CBOFS获取纬度38.98、经度-76.48的水位预报”
• “将CBOFS水位与8571892站的CO-OPS观测值进行比较”
• “列出当前可用的NGOFS2预测周期”

RTOFS查询：

• “获取北纬40°、西经74°的RTOFS海面温度预报”
• “显示墨西哥湾流中的温度深度剖面”
• “HYCOM THREDDS上目前有哪些RTOFS数据集？”
• “获得从迈阿密到百慕大的盐度垂直横断面”
• “显示墨西哥湾SST区域预报”

WW3查询：

• “有哪些GFS Wave模型网格可用？”
• “查找哈特拉斯角附近的NDBC浮标”
• “从41025号浮标获取最新的波浪观测数据”
• “给我看看未来48小时北纬35°、西经75°的GFS波浪预报”
• “将波浪预报与41025号浮标观测结果进行比较”

跨服务器查询：

• “查找ERDDAP浮标位置附近的CO-OPS站”
• “将潮汐站数据与附近的ERDDAP卫星SST进行比较”
• “墨西哥湾沿岸是否有活跃的飓风威胁？如果有，请向我展示新奥尔良的STOFS风暴潮预报”
• “获取切萨皮克湾的CBOFS水位预报，并将其与同一站的CO-OPS潮汐预报进行比较”
• “显示电池附近ERDDAP的海面温度和CO-OPS的当前水位”
• “历史上哪些NHC风暴袭击了墨西哥湾沿岸？显示受影响站点的CO-OPS洪水统计数据”
• “获取同一位置的STOFS网格预报和OFS水位预报，并进行比较”

建筑

每个服务器都是完全独立的，有自己的 pyproject.toml、依赖关系和测试。看 docs/architecture.md 有关共享约定的详细信息。

跨服务器的共享模式：

• MCP服务器框架的FastMCP
• httpx用于异步HTTP客户端
• Pydantic用于参数验证
• 只读工具（无数据修改）
• 双标记/JSON输出格式
• 带有建议的可操作错误消息

引用

如果您在研究或工作中使用此项目，请引用：

@software{jisan2025oceanmcp,
  author    = {Jisan, Mansur Ali},
  title     = {Ocean MCP: Real-Time Marine Data, MCP-Native},
  year      = {2025},
  url       = {https://github.com/mansurjisan/ocean-mcp},
  note      = {MCP servers for NOAA CO-OPS, ERDDAP, NHC, Recon, STOFS, OFS, RTOFS, and WW3 data}
}

许可证

根据MIT许可证获得许可。您可以根据MIT条款使用、修改和分发此软件。看 许可证 了解详情。