NOAA Tides MCP Server

NOAA Tides MCP 服务

此 MCP 服务通过模型上下文协议提供 NOAA CO-OPS（业务海洋产品与服务中心）数据。

功能

• 获取特定站点的水位数据
• 获取潮汐预报（高潮／低潮）
• 获取站点信息和元数据

安装

uv add mcp[cli]
uv add httpx

开发环境设置

如需设置包含测试依赖项的开发环境：

# Install test dependencies
uv add pytest pytest-asyncio pytest-httpx pytest-mock

测试

项目使用 pytest 进行测试。测试套件包括：

• 所有 API 端点的单元测试
• 错误处理测试
• 参数验证测试
• 使用 pytest-httpx 模拟 HTTP 响应

运行测试：

# Run all tests with verbose output
pytest -v

# Run a specific test file
pytest tests/test_server.py -v

# Run a specific test function
pytest tests/test_server.py::test_get_water_levels -v

用法

服务提供三个主要工具：

1. get_water_levels：获取特定站点的水位数据

   • 参数：
     • station_id：7 位站点 ID
     • begin_date：开始日期，格式为 yyyyMMdd（可选）
     • end_date：结束日期，格式为 yyyyMMdd（可选）
     • datum：垂直基准面（默认：MLLW）
     • time_zone：时区（默认：gmt）
     • units：测量单位（默认：english）

2. get_tide_predictions：获取特定站点的潮汐预报

   • 参数：
     • station_id：7 位站点 ID
     • begin_date：开始日期，格式为 yyyyMMdd（可选）
     • end_date：结束日期，格式为 yyyyMMdd（可选）
     • datum：垂直基准面（默认：MLLW）
     • time_zone：时区（默认：gmt）
     • units：测量单位（默认：english）
     • interval：预报间隔（默认：hilo，即高潮／低潮）

3. get_station_info：获取特定站点的信息

   • 参数：
     • station_id：7 位站点 ID

示例站点 ID

• 9414290：加利福尼亚州旧金山
• 8518750：纽约州 The Battery
• 8557863：马里兰州雷霍博斯海滩

运行服务

python server.py

与 Claude Desktop 配合使用

如需在 Claude Desktop 中使用此服务，请使用以下配置字符串添加该服务：

python:/path/to/your/server.py

将 /path/to/your/server.py 替换为 server.py 文件的实际路径。

许可证

MIT