surfline-mcp

Servidor MCP de Python minimalista con una herramienta: get_surf_forecast.

Obtiene ambos endpoints de pronóstico de Surfline:

• conditions

• rating

El punto está fijado mediante una variable de entorno (SURFLINE_SPOT_ID), por lo que este servidor es efectivamente para un solo punto.

Configuración

cd surfline-mcp
uv sync

Ejecución (servidor MCP stdio)

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

Ejecución mediante uvx (desde GitHub)

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

Configuración de Nanobot MCP (uvx)

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

Herramienta

get_surf_forecast(days=3)

Devuelve:

• spot_id

• days

• daily_forecast[] con:

  • forecastDay

  • dayToWatch

  • headline

  • observation

  • rating_summary.dominant_key

  • rating_summary.min_value

  • rating_summary.max_value

  • rating_summary.avg_value

  • rating_windows[] como instantáneas compactas de 3 horas:

    • local_hour

    • key

    • value