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