loading…
Search for a command to run...
loading…
A minimal Python MCP server that provides surf forecasts for a single Surfline spot. It fetches both conditions and rating data through the get_surf_forecast to
A minimal Python MCP server that provides surf forecasts for a single Surfline spot. It fetches both conditions and rating data through the get_surf_forecast tool.
Minimal Python MCP server with one tool: get_surf_forecast.
It fetches both Surfline forecast endpoints:
conditionsratingThe spot is fixed by environment variable (SURFLINE_SPOT_ID) so this server is effectively single-spot.
cd surfline-mcp
uv sync
cd surfline-mcp
export SURFLINE_SPOT_ID=5842041f4e65fad6a7708852
uv run surfline-mcp
export SURFLINE_SPOT_ID=5842041f4e65fad6a7708852
uvx --from git+https://github.com/ivoytov/surfline-mcp surfline-mcp
{
"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)
Returns:
spot_iddaysdaily_forecast[] with:forecastDaydayToWatchheadlineobservationrating_summary.dominant_keyrating_summary.min_valuerating_summary.max_valuerating_summary.avg_valuerating_windows[] as compact 3-hour snapshots:local_hourkeyvalueДобавь это в claude_desktop_config.json и перезапусти Claude Desktop.
{
"mcpServers": {
"surfline-mcp": {
"command": "npx",
"args": []
}
}
}