🏖️ 海滩安全MCP
了解世界上任何海滩的全面海滩和冲浪条件——只需说出名字。大多数数据不需要API密钥。
“威基基的冲浪怎么样？”→ 即时完整报告
所得
- 🌊 波浪 --高度、周期、方向
- 🌫️ 膨胀 --涌浪高度、周期、方向
- 💨 风 --速度和方向
- 🌡️ 温度 --空气和水
- ☀️ 紫外线指数 --当前紫外线+每日最大值，日夜感知 *（免费，无API密钥）*
- ⚠️ 撕裂当前风险 --低/中/高
- 🛡️ 安全评分 --1-10条建议
数据源（全部免费-无API密钥）
| 来源 | 数据 |
|---|---|
| OpenStreetMap/Photons | 海滩名称→ 坐标 |
| Open Meteo Marine | 波高、涌浪、洋流 |
| 开放气象天气 | 气温、风、降水、紫外线指数 |
| 美国国家海洋和大气管理局国家气象局 | 激流风险，冲浪区预测 |
UV索引数据免费来自Open-Meteo-不需要API密钥。
安装
1.克隆/复制项目
git clone
cd beach-safety-mcp或者只是复制 src/server.py 文件到任何你想要的地方。
2.添加到mcporter
mcporter config add beach-safety \
--command python3 \
--args "path/to/beach-safety-mcp/src/server.py" \
--cwd "path/to/beach-safety-mcp/config"手动添加到mcporter
或手动添加到 ~/.openclaw/workspace/config/mcporter.json:
{
"beach-safety": {
"command": "python3",
"args": ["/full/path/to/beach-safety-mcp/src/server.py"]
}
}3.测试一下
mcporter call beach-safety.get_beach_json beach_name="Waikiki"用法
来自任何AI助手（通过mcporter）
get_beach_report(beach_name="Waikiki")
get_beach_report(beach_name="Bondi Beach, Sydney")
get_beach_report(beach_name="Cocoa Beach, FL")只需说出海滩名称，坐标就会自动解析。
从CLI
python3 beach_lookup.py "Waikiki"
python3 beach_lookup.py "Praia da Rocha, Portugal"
python3 beach_lookup.py "Bondi Beach, Sydney"仅冲浪预报
mcporter call beach-safety.get_surf_forecast lat=21.27 lon=-157.82输出示例
🌊 Bondi Beach, Sydney Beach Conditions
Lat/Lon: -33.8907, 151.2724
Updated: 2026-03-23T10:30:00Z UTC
🛡️ SAFETY (Score: 8/10)
Rip Current Risk: Moderate
Safety: Moderate rip current risk
🌊 WAVES
Wave Height: 2.8 ft (0.84m)
Wave Period: 6.7 sec
Swell: 2.4 ft @ 4.8 sec from E
💨 WIND
Speed: 4.0 mph from NE
🌡️ TEMPERATURE
Air: 68°F | Water: 75°F
☀️ UV INDEX: current=6 (daily max=9) (Very High) — sunscreen recommended
*(at night shows current=0 with daily max, UV risk based on max)*
📋 RECOMMENDATIONS:
⚠️ Swim near a lifeguard. Be aware of rip currents.安全评分指南
| 分数 | 含义 | 行动 |
|---|---|---|
| 9-10 | 一般安全 | 享受正常预防措施 |
| 7-8 | 次要问题 | 建议谨慎 |
| 4-6 | 注意 | 靠近救生员游泳 |
| 1-3 | 危险 | 远离水 |
备注
- 适用于全球任何海滩——只要说出它的名字
- 美国国家海洋和大气管理局冲浪区数据对美国海岸最为详细
- Open Meteo海洋数据覆盖全球海洋
- 一些不太著名的海滩可能无法解决——尝试添加国家/州（例如，“印度尼西亚巴厘岛库塔海滩”）
- 海滩名称→ 由OpenStreetMap+Photons提供的坐标（免费）
项目结构
beach-safety-mcp/
├── src/
│ └── server.py # MCP server (Python, stdio)
├── beach_lookup.py # CLI tool
├── LICENSE # MIT License
└── README.md