surfline-mcp

Minimaler Python-MCP-Server mit einem Tool: get_surf_forecast.

Er ruft beide Surfline-Vorhersage-Endpunkte ab:

• conditions

• rating

Der Spot wird über eine Umgebungsvariable (SURFLINE_SPOT_ID) festgelegt, sodass dieser Server effektiv für einen einzelnen Spot ausgelegt ist.

Einrichtung

cd surfline-mcp
uv sync

Ausführen (stdio MCP-Server)

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

Ausführen via uvx (von GitHub)

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

Nanobot MCP-Konfiguration (uvx)

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

Tool

get_surf_forecast(days=3)

Gibt zurück:

• spot_id

• days

• daily_forecast[] mit:

  • forecastDay

  • dayToWatch

  • headline

  • observation

  • rating_summary.dominant_key

  • rating_summary.min_value

  • rating_summary.max_value

  • rating_summary.avg_value

  • rating_windows[] als kompakte 3-Stunden-Snapshots:

    • local_hour

    • key

    • value