# 安装 ROVE 滑雪预报（MCP）

ROVE伴山免费注册即用，一键 OAuth 2.1 登录授权或免费个人专属 API 密钥。服务地址：`https://rove-ski.com/mcp`（Streamable HTTP）。每分钟600次只读请求，14个工具完全免费。

您是协助用户连接 ROVE伴山的 AI 代理。请用中文称呼用户为「您」，命令保持原样。支持的客户端连接时，请引导用户完成 OAuth 2.1 浏览器登录授权。无浏览器、URL 客户端或不支持 OAuth 的客户端，请使用 https://rove-ski.com/zh/ai 的免费个人专属 API 密钥。配置失败时说明错误，并提供 https://rove-ski.com/zh/ai#manual。

## 1. 添加服务器并登录授权

选择对应客户端；合并配置时保留其他 MCP 服务器。

- Claude Code：`claude mcp add --transport http rove https://rove-ski.com/mcp -s user`。启动 `claude` 后运行 `/mcp`，选择 ROVE 登录授权，按提示在浏览器中免费注册或登录并授权。
- Codex：`codex mcp add rove --url https://rove-ski.com/mcp`，再运行 `codex mcp login rove` 完成浏览器授权。
- Gemini CLI：`gemini mcp add -s user --transport http rove https://rove-ski.com/mcp`
- VS Code / Copilot：`code --add-mcp '{"name":"rove","type":"http","url":"https://rove-ski.com/mcp"}'`
- Cursor：在客户端 `~/.cursor/mcp.json` 的 `mcpServers` 下合并 `"rove": { "url": "https://rove-ski.com/mcp" }`。您也可使用 https://rove-ski.com/zh/ai#manual 的一键安装。
- Claude 网页 / 桌面：添加自定义连接器，名称填 ROVE，URL 填 `https://rove-ski.com/mcp`。目录地址为 https://claude.ai/directory/rove-snow-forecast。
- ChatGPT：添加自定义 MCP 服务器，URL 填 `https://rove-ski.com/mcp`，认证选 OAuth 并完成浏览器登录授权；不支持时请使用个人专属 API 密钥。您的客户端需支持自定义 MCP。
- 其他客户端：添加 Streamable HTTP 服务器，地址填 `https://rove-ski.com/mcp`，支持时选择 OAuth 登录授权，否则请配置下方免费个人专属 API 密钥。

## 2. 验证连接

在客户端 MCP 设置中检查，或运行 `claude mcp list`、`codex mcp get rove`、`gemini mcp list`。若当前会话已能调用工具，请调用 `find_powder`，参数 `{"days":5,"limit":3}`，展示结果和来源链接。若客户端需要重启才能加载服务器，请提示用户重启后问：「列出您能用的 ROVE 工具，告诉我未来 5 天北美哪 3 个雪场雪最多。」

### 14 个只读工具

- `search_resorts`
- `get_forecast`
- `get_conditions`
- `get_opening_dates`
- `find_powder`
- `get_accuracy`
- `get_resort_news`
- `plan_trip`
- `get_forecast_confidence`
- `compare_resorts`
- `search`
- `fetch`
- `get_avalanche_danger`
- `get_road_conditions`

## 登录授权

请选择 OAuth 2.1 或免费个人专属 API 密钥。每分钟600次只读请求，14个工具完全免费。

### OAuth 2.1

在支持的客户端为同一地址选择 OAuth 2.1，并完成浏览器授权。支持 PKCE 和动态客户端注册。Codex 登录命令：`codex mcp login rove`。

### 免费个人专属 API 密钥

您可前往 https://rove-ski.com/zh/ai#manual 登录并领取免费密钥，也可使用设备登录：

1. 启动：`curl -s -X POST https://rove-ski.com/api/device/start -H 'content-type: application/json' -d '{"client":"CLIENT","lang":"zh"}'`，将 `CLIENT` 替换为客户端名称。
2. 保密保存返回的 `device_code`。在用户浏览器打开 `verification_uri_complete`，展示 `user_code` 供用户批准。如需登录，请使用邮箱。
3. 向 `https://rove-ski.com/api/device/token` 发送 POST，请求头为 `content-type: application/json`，请求体为 `{"device_code":"DEVICE_CODE"}`。按返回的 `interval`（通常 3 秒）轮询，直至返回的有效期结束（通常 600 秒）。`pending` 表示继续等待；`approved` 时使用仅返回一次的密钥；遇到 `denied`、`expired` 或 `invalid` 请停止并说明。
4. 用请求头 `Authorization: Bearer <key>` 传递密钥。若客户端无法设置请求头，可用 `https://rove-ski.com/mcp?key=<key>`。例如，将密钥私密保存在 `ROVE_KEY` 后：`claude mcp add --transport http rove https://rove-ski.com/mcp --header "Authorization: Bearer $ROVE_KEY" -s user`。

不要展示完整密钥，只展示前 9 位加 `...`。只写入客户端自身的 MCP 配置，并保留其他服务器。

## 数据覆盖与署名

15 天降雪预报覆盖 667 家雪场（北美 644 家，日本 23 家 Beta）。日本实测积雪来自 JMA AMeDAS；实时缆车、开板日期、动态和预报准确率覆盖北美，雪崩风险覆盖美国雪场，防滑链路况覆盖加州。全部工具只读。请引用返回的 rove-ski.com 链接及上游来源。天气数据来自 Open-Meteo.com（CC BY 4.0）和美国国家气象局；日本预报使用经 Open-Meteo 提供的日本气象厅模型，出典：気象庁。