surfline-mcp

get_surf_forecastという1つのツールを備えた、最小限の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