surfline-mcp

get_surf_forecast 도구 하나를 포함하는 최소한의 Python MCP 서버입니다.

다음 두 가지 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