surfline-mcp

极简的 Python MCP 服务器，包含一个工具：get_surf_forecast。

它会获取两个 Surfline 预报端点的数据：

conditions（海况）
rating（评分）

冲浪点通过环境变量 (SURFLINE_SPOT_ID) 固定，因此该服务器实际上仅支持单个冲浪点。

设置

cd surfline-mcp
uv sync

运行 (stdio MCP 服务器)

cd surfline-mcp
export SURFLINE_SPOT_ID=5842041f4e65fad6a7708852
uv run surfline-mcp

通过 uvx 运行 (来自 GitHub)

export SURFLINE_SPOT_ID=5842041f4e65fad6a7708852
uvx --from git+https://github.com/ivoytov/surfline-mcp surfline-mcp

Nanobot MCP 配置 (uvx)

{
  "tools": {
    "mcpServers": {
      "surfline": {
        "command": "uvx",
        "args": ["--from", "git+https://github.com/ivoytov/surfline-mcp", "surfline-mcp"],
        "env": {
          "SURFLINE_SPOT_ID": "5842041f4e65fad6a7708852"
        }
      }
    }
  }
}

工具

get_surf_forecast(days=3)

返回：

spot_id
days
daily_forecast[]，包含：
- forecastDay
- dayToWatch
- headline
- observation
- rating_summary.dominant_key
- rating_summary.min_value
- rating_summary.max_value
- rating_summary.avg_value
- rating_windows[]（以 3 小时为间隔的紧凑快照）：
  - local_hour
  - key
  - value