Riverside MCP

Riverside + AI - 适用于 ChatGPT、Claude、GitHub Copilot、Microsoft 365 Copilot、Gemini，以及任何支持 MCP 的 Agent

非官方。由社区构建的 Claude Code Skill 和 Riverside API MCP 服务。与 RiversideFM, Inc. 无关联，也未获得其认可或赞助。

_{完整的 Skill 页面 - 安装、使用效果、安全模型。}

将 Riverside API 功能作为 MCP 工具提供。可与您已在使用的 AI 搭配使用 - ChatGPT（Plus/Pro+，暂停使用，直至重新发布此连接器；请参阅 mcp-install.md）、Claude Desktop、Codex、Claude Code、Claude Cowork 和 GitHub Copilot - 以及通过远程方式使用的 Microsoft 365 Copilot / Copilot Studio 和 Google Gemini。免费、开源，可在您的笔记本电脑上运行。专为 MSP 所有者打造。无需编写代码。

适用于您的 Agent

安全提示（重新发布此连接器前适用）。 请勿将此 连接器接入 supergateway 桥接服务或任何其他 stdio-to-HTTP 桥接服务， 即使在 localhost 上也不行。该桥接服务没有添加密码，因此任何可以访问 其端口的人都能使用您的凭据调用 MCP 工具。请使用默认的 stdio 传输方式。如果您为远程 Agent 设置了桥接服务或隧道，请将其 关闭。修复即将推出。

MSP 所有者实际使用的六种 Agent（自助使用，即刻可用）：

您的 AI Agent	Riverside Skill 的安装方式
Claude Desktop	运行安装程序，然后前往 Settings > Extensions 注册 riverside-fm-mcp（无需编辑 JSON）。
ChatGPT（付费套餐）	暂停使用，直至重新发布此连接器：ChatGPT 需要 HTTPS 服务，而此版本仅支持 stdio，因此需要使用不添加密码的 stdio-to-HTTP 桥接服务。请参阅 mcp-install.md 中的安全提示。
Codex CLI	粘贴下方的安装提示词。
Claude Code	粘贴下方的安装提示词。
Claude Cowork	粘贴下方的安装提示词。
GitHub Copilot（VS Code）	运行安装程序，在 mcp.json 的 servers 键下添加 riverside-fm-mcp，然后选择 Agent 模式。

ChatGPT 需要远程 HTTPS 服务。此连接器仅支持 stdio，因此需要使用不添加密码的 stdio-to-HTTP 桥接服务；该方案暂停使用，直至重新发布此连接器。请参阅 mcp-install.md 中的安全提示。

同样适用于 Microsoft 和 Google 生态

用户群庞大，但需要坦诚说明：这属于远程 / 企业方案，并非您刚刚安装的本地二进制文件。

Agent	所需条件
Microsoft 365 Copilot / Copilot Studio	暂停使用，直至重新发布此连接器：Copilot Studio 需要 HTTPS 服务，而此版本仅支持 stdio，因此需要使用不添加密码的 stdio-to-HTTP 桥接服务。请参阅 mcp-install.md 中的安全提示。
Google Gemini	Gemini CLI 在本地运行 - 与 Claude Code 相同。Gemini app 通过远程方式运行，需要使用与 ChatGPT 相同的远程方案，该方案目前暂停使用。请参阅 mcp-install.md。

原生支持 Skill 的 Agent（同样涵盖）： Hermes 和 OpenClaw 可直接读取此 Skill 的 SKILL.md，并且支持 MCP - 请参阅下方的安装部分。也可通过 MCP 与 Cursor、Windsurf、Cline、Continue.dev 和 Zed 搭配使用。各工具的完整接入说明：docs/which-agent.md。

要使用多个 Agent？ 运行一条命令，即可在所有 51+ 个受支持的 Agent 中安装：npx skills add Servosity/msp-skills@latest（需要 Node.js，然后运行各 Skill 的安装程序以安装 CLI/MCP 二进制文件）。请参阅 docs/which-agent.md。

60 秒内完成安装

Claude Desktop 最快安装方式 - 单击 .mcpb

下载 Riverside MCP (.mcpb) - 然后打开 Claude Desktop > 设置 > 扩展 并选择该文件。单击即可，无需 JSON 或 Shell。（在发布页面查看所有 Riverside 版本。）

更喜欢使用 Claude Code 插件？添加一次市场，然后安装即可立即使用，无需列出目录：

/plugin marketplace add Servosity/msp-skills
/plugin install riverside-fm@msp-skills

方式 A - 向 AI Agent 粘贴一条提示词（推荐）

将以下内容复制到 Claude Code、Codex CLI 或 Claude Cowork 中：

在此 Agent 工作区中安装来自 Servosity/msp-skills 的 Riverside Skill 和 MCP 服务。如果此工作区使用 POSIX Shell（macOS、Linux、WSL 或 Bash），请运行 bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/riverside-fm/install.sh)。如果使用 Windows PowerShell，请运行 iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/riverside-fm/install.ps1 | iex。然后按照 README 进行身份验证，并运行 riverside-fm-cli --help 以了解用法。

这条提示词也适用于任何能够运行 Shell 的 Agent。

方式 B - 自行运行安装程序

Windows（PowerShell）：

iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/riverside-fm/install.ps1 | iex

macOS / Linux：

bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/riverside-fm/install.sh)

安装程序会将 riverside-fm-cli（CLI）和 riverside-fm-mcp（MCP 服务）放入用户的 bin 路径。Claude Code、Codex 和 Cowork 会通过此目录中的 SKILL.md 发现 Skill。

验证：

riverside-fm-cli --version

升级到最新版本

安装程序始终获取当前版本 - 重新运行即可升级：

macOS / Linux：

bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/riverside-fm/install.sh)

Windows（PowerShell）：

iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/riverside-fm/install.ps1 | iex

Claude Desktop .mcpb 用户：下载最新的 .mcpb（位于本节顶部），然后在 设置 > 扩展 中重新选择该文件。Claude Code 插件用户：/plugin update riverside-fm@msp-skills。

添加到 Claude Desktop、GitHub Copilot、Gemini CLI、Microsoft 365 Copilot 或其他 MCP 客户端

运行安装程序后，请参阅 mcp-install.md 和 docs/which-agent.md，了解各 Agent 的连接配置方式 - 每个 Agent 都有单独的说明，其中包括 GitHub Copilot 的 servers 键，以及远程 Microsoft 365 Copilot / Copilot Studio 的配置方式。Claude Desktop 的“设置 > 扩展”面板是最简单的方式；mcp-install.md 中记录了 MCP 配置块（适用于偏好编辑 JSON 的用户）。

为 Hermes 安装

在 Hermes CLI 中：

hermes skills install servosity/msp-skills/skills/riverside-fm --force

在 Hermes 聊天会话中：

/skills install servosity/msp-skills/skills/riverside-fm --force

Hermes 原生支持 MCP，因此也可以直接使用 riverside-fm-mcp 服务 - 安装方式和环境变量均相同。

为 OpenClaw 安装

告诉你的 OpenClaw Agent（复制以下内容）：

从 https://github.com/servosity/msp-skills/tree/main/skills/riverside-fm 安装 riverside-fm skill。该 Skill 会说明如何通过 openclaw: frontmatter 块安装所需的 CLI（riverside-fm-cli）。

OpenClaw 目前尚未普遍开放；frontmatter 配置已预先提供，OpenClaw 一经发布便会启用。

身份验证

请参阅 mcp-install.md，了解 riverside-fm-cli 所需的凭据。

此技能的功能

你反复提出的问题	命令
将某个工作室中的所有内容备份到磁盘？	riverside-fm-cli bulk export --studio my-studio --out ./archive
一次性获取某段录制最有用的素材？	riverside-fm-cli grab <session-id> --out ./dl
在整个转录文本存档中查找一句引述？	riverside-fm-cli search "network effects" --json
将转录文本转换为网页播放器的字幕？	riverside-fm-cli transcripts convert <session-id> --format srt --out ep.srt
这一期里谁说得最多？	riverside-fm-cli transcripts talktime <session-id> --json
工作室中哪些录制内容已完全准备好进行剪辑？	riverside-fm-cli ready --studio my-studio
获取某个项目的所有 Magic Clip，并生成新的 URL？	riverside-fm-cli clips harvest --project 69fcda9fba030a19ae93a526 --download --out ./clips
在 CloudFront 媒体链接过期前刷新它们？	riverside-fm-cli media refresh --project 69fcda9fba030a19ae93a526 --prefetch --out ./media

完整命令参考：guide.md。有关 AI Agent 操作约定（--agent、--dry-run，以及执行变更前何时需要确认），请参阅 AGENTS.md。

与众不同之处

大多数 Riverside 集成和 MCP 服务会将每个问题转发为实时 API 调用。对于单条记录，这样做没问题。但规模一大就行不通了：例如，你想要“在两年的每周节目中找出提到那个客户故事的那一期”，或是“取消套餐前归档这个工作室中的所有录制内容”。

此技能会将 Riverside 同步到一个包含全文搜索的本地 SQLite 镜像中。聚合查询只需执行一次本地查询：即时、离线，AI 看到的是答案，而不是原始数据。bulk export、clips harvest 和 search 等复合命令可以关联工作室、项目、录制内容、转录文本和剪辑素材，而无状态的 API 封装器无法做到这一点。

解决的痛点

Riverside 能录制录音棚音质的播客和视频，但要取回自己的内容，却是一项繁琐的手动工作。平台没有批量导出功能：每份转录文本、音轨和视频文件都必须逐个点击下载，按“工作室 → 项目 → 录制内容”的路径操作。备份一档有 50 期的节目，就要点击数百次。这种操作之繁琐显而易见，播客社区群组（例如 Podcasting 子版块和播客主持人 Facebook 群组）里的人们不断询问如何“批量下载 Riverside 录制内容”，以便归档系列节目或释放存储空间。而能解决这一问题的官方 API 仅向采用定制价格的 Business 套餐开放，因此 Pro、Live 和 Webinar 账户没有受支持的方式来备份、搜索或重新格式化自己的录制内容。

此技能填补了这一空白：

• bulk export - 将整个工作室（或指定日期范围内的内容）归档到磁盘，并支持断点续传。
• grab - 使用一条命令下载某段录制最有用的素材（依次尝试转录文本、音频、视频）。
• search - 在本地镜像中的所有转录文本内进行全文搜索。
• transcripts convert - 将转录文本转换为 WebVTT / SRT / Markdown 字幕，这些格式在 Riverside 界面中无法导出。
• clips harvest - 获取某个项目的所有 Magic Clip，并刷新下载 URL。

更详细的说明请参阅 pain-point.md。

常见问题

这能与 ChatGPT 配合使用吗？

此版本不支持。ChatGPT（Plus、Pro、Team、Business、Enterprise 和 Education 套餐；Free 套餐目前尚未提供 Developer Mode）只能通过 HTTPS 连接到远程 MCP 服务。Riverside MCP 服务仅支持 stdio，因此需要在它前面部署一个 stdio-to-HTTP 桥接服务，而这个桥接服务不会增加任何密码保护。在重新发布连接器之前，请勿部署此桥接服务，也不要将其置于隧道后；原因请参阅 mcp-install.md 中的安全说明。在此之前，请使用 Claude Desktop、Claude Code 或 Codex。

这适用于 Codex、Cursor、Windsurf、Cline、Copilot 或 Gemini 吗？

适用——它们都支持 MCP。上方的矩阵中提供了跨工具安装命令，docs/which-agent.md 中则有深入介绍。

我需要懂编程吗？

不需要。推荐的安装方式是在 Claude Code 或 Codex 中粘贴一句话——你的 Agent 会读取 SKILL.md 并完成安装。备用方式是在每种操作系统上使用一行安装程序（bash 或 PowerShell）。这两种方式都不需要编写代码。你只需输入一次 Riverside 凭据。

我的 Riverside 数据安全吗？

你的数据会留在自己的设备上。CLI 和 MCP 服务都是本地二进制文件。SQLite 镜像存放在你用户帐户下的目录中。AI Agent 只能看到 CLI 返回的内容——通常是查询结果，而不是原始批量数据。凭据从你的环境或 Agent 配置中读取；MSP Skills 不会将其打包进此仓库，也不会将其传输到任何地方。

我需要 Riverside Business 套餐或 API 密钥吗？

不需要。Riverside 官方 API 需要价格定制的 Business 套餐。此 CLI 会重用你已登录浏览器中的会话 Cookie，以访问 Riverside 网页应用所用的同一内部 API，因此 Pro、Live 和 Webinar 帐户即使无法申请 API 密钥，也能使用。只需运行一次 riverside-fm-cli auth login --chrome。

这能下载其他人的录音吗？

不能。它使用你自己的浏览器会话，以你的身份进行验证，并且只能访问你的帐户已有权限访问的工作室和录制片段。它仅用于导出你自己的内容，不会抓取他人的内容。

这会更改我的 Riverside 帐户中的任何内容吗？

你用于导出、搜索和转换的命令都是读取操作——只会下载和转换你的数据。CLI 确实包含通用的 import 命令，它可以通过 API 的创建/更新路径，从本地文件 POST 记录；但此技能中的任何工作流都不会使用它，Agent 应将其视为需审核的写入操作。此 CLI 中没有任何命令会删除或发布内容。

费用是多少？

免费。采用 Apache-2.0 许可证。你只需为所用的 AI Agent（Claude、ChatGPT、Codex 等）付费，费用由你的 AI 服务提供商收取，而不是我们。

安全模型

此技能中的 Riverside 数据命令都是读取操作：导出、搜索、下载和转录命令只会对你的帐户发送 GET 请求。唯一会修改数据的命令是通用的 import，它会从本地 JSONL 文件 POST 记录——此命令不属于此处的任何导出工作流。

层级	示例	推荐的 Agent 策略
读取	bulk export、grab、search、transcripts convert、transcripts talktime、clips harvest、media refresh、ready、wait、sync	允许
写入（常规）	import（通过 API 的创建/更新路径，从本地 JSONL 文件 POST 记录）；端点镜像功能检查中被安全扫描器按动词名称标记的部分（ai can-create-event、takes get-assets、clips get-patches）本身都是只读 GET 请求	先用 --dry-run 预览，再执行经审核的写入操作
破坏性操作 / 配置	无——此 CLI 不提供删除、发布或帐户配置命令	仅允许人工介入

最重要的控制措施是你授予 Riverside 凭据的权限范围——CLI 只能执行凭据允许的操作。完整详情（包括如何限制权限）请参阅 governance.md。

状态

Beta。已根据 Riverside API 接口进行验证，并在每周的 Build Sessions 中，由正在将其连接到各自生产租户并实际运行的 MSP 进行验证。在 compoundingteams.com/build-sessions 报名参加。

---

标准。 符合开放的 Agent Skills 规范（Anthropic，2025 年 12 月；支持 40+ 个 Agent）。兼容 MCP——适用于任何支持 MCP 的 Agent，包括 Hermes。已为 OpenClaw 做好准备（frontmatter 已预先配置，等待 OpenClaw 发布）。

由 Servosity 维护。采用 Apache-2.0 许可。使用 CLI Printing Press 构建。最后更新：2026-06-30。