superwhisper CLI：怎样安装，每一条命令，以及 MCP 服务器

作者 · 发布于

superwhisper 有一个命令行工具，在 Mac 上同样叫 superwhisper。它可以搜索和导出你本地的听写历史，编辑词汇和替换，也可以控制正在运行的 App：开始、停止、切换模式、转写文件。它还可以作为 MCP（Model Context Protocol）服务器运行，让 AI 助手搜索和读取你的听写内容。

我做的是 YapToText，另一款 Mac 听写 App，所以读我写的关于 superwhisper 的内容时，请记住这一点。这里关于 superwhisper 的每一个事实都来自它自己的文档，我在2026年10月10日读过。相关页面是 CLI and MCP server。

在 Mac App Store 下载 YapToText免费下载。无需账号，没有锁定的功能。需要搭载 Apple 芯片的 Mac 和 macOS 14 或更高版本。 源代码在 GitHub 上。

用其他语言阅读： English, العربية, Čeština, Dansk, Deutsch, Ελληνικά, Español, Suomi, Français, עברית, हिन्दी, Magyar, Bahasa Indonesia, Italiano, 日本語, 한국어, Norsk, Nederlands, Polski, Português, Română, Русский, Slovenčina, Svenska, ไทย, Türkçe, Українська, Tiếng Việt, 繁體中文

安装

curl -fsSL https://superwhisper.com/install-cli.sh | bash

会发生什么：这个脚本会把最新版本安装到 /usr/local/bin，如果那里不可写，就装到 ~/.local/bin。

如果装完之后你的 shell 找不到 superwhisper，请把 ~/.local/bin 加进 PATH。文档说，二进制文件和校验和发布在 GitHub 的 superultrainc/superwhisper-cli-release 仓库里，所以你可以先读安装脚本再运行。这个 CLI 只支持 macOS。

读取历史记录的命令

出自 superwhisper 的文档页面 CLI and MCP server，2026年10月10日查阅。这些命令读取的是和 App 同一个本地数据库，在你的设备上运行。

命令作用
search在所有转写文字中做全文搜索。支持 AND、OR、NOT、带引号的短语和前缀星号
history列出最近的转写。可以用 --mode、--since 和 --before 筛选
read读取一条转写，不给 ID 就读最新的一条。--raw 显示 AI 处理之前的文字
stats转写统计数据
modes列出你的录音里用过的模式，并给出次数
export从最早的开始导出全部内容，格式为 jsonl 或 markdown
vocab列出、添加或删除词汇
snippets列出、设置或删除替换，和 Settings，Vocabulary 里的 From 与 To 配对一样
doctor数据库的诊断信息，用于提交 bug 报告
completions生成 shell 补全

控制 App 的命令

出自同一个页面。这些命令会向正在运行的 App 发送请求，所以 superwhisper 必须是打开的。

命令作用
record切换录制状态
start开始录制。已经在录制时什么也不做
stop停止录制。没有在录制时什么也不做
switch按名称或 key 切换当前模式。不带参数时，列出你的模式
settings打开设置窗口
transcribe把一个音频文件发给 App 去转写。文件转写需要 Pro

start、stop 和 switch 让 superwhisper 可以被任何能运行 shell 命令的东西用脚本控制。其中包括启动器、键盘映射工具，或者辅助开关界面上的一个按钮。

示例

superwhisper search "quarterly report"
superwhisper history --since 2026-09-01 --mode Mail
superwhisper read --raw
superwhisper export -f markdown > dictations.md
superwhisper vocab add "Superwhisper"
superwhisper switch Message
superwhisper transcribe ~/Downloads/note.m4a

会发生什么：每一行都是文档自己给的示例。大多数命令还接受 --json，输出可供脚本读取的结果。

MCP 服务器

superwhisper mcp

会发生什么：这个 CLI 通过 stdio 使用 MCP 协议，并提供用于搜索、历史记录、读取录音、模式、统计、词汇和文本替换的工具。

文档里有一个隐私要点：CLI 本身完全在你的设备上运行，但当 AI 助手通过 MCP 连接上来时，它查询到的转写文字会被发给那个助手，并按它自己的模型和数据设置来处理。superwhisper 隐私页面讲了其余部分。

YapToText 和命令行

YapToText 没有命令行工具，也没有 MCP 服务器。它是一款菜单栏 App，只用一个键。它的 History 页面可以把整个列表导出为纯文本或 Markdown，不用终端就能满足导出的需求。

想在终端里转写又不想花钱，whisper.cpp 就是 YapToText 所基于的引擎。本地 Whisper 指南里有命令，MacWhisper CLI 页面介绍了另一款 App 用于文件和文件夹的工具。

在 Mac App Store 下载 YapToText免费下载。无需账号，没有锁定的功能。需要搭载 Apple 芯片的 Mac 和 macOS 14 或更高版本。 源代码在 GitHub 上。

简要小结

  • 安装。一行 curl，仅限 macOS。
  • 读取。search、history、read、stats 和 export。
  • 控制。record、start、stop、switch 和 transcribe，需要 App 处于打开状态。
  • MCP。superwhisper mcp，通过 stdio。
  • 隐私。本地运行，直到有助手通过 MCP 读取转写文字。

如果 superwhisper 增加或改了命令名，请在 GitHub 上提交 issue（英文），我会更新这一页。每一条我都会看。

在 Mac App Store 下载 YapToText免费下载。无需账号，没有锁定的功能。需要搭载 Apple 芯片的 Mac 和 macOS 14 或更高版本。 源代码在 GitHub 上。

关于作者。 Ryleigh Newman 从事软件开发，用手打字有困难，每天都用本站介绍的 YapToText 听写。本页译自英文。App 的界面和网站的其他页面是英文的。 进一步了解这个项目（英文）。

指南

更多指南（英文）

资料来源

常见问题

superwhisper 有 CLI 吗？

有，在 macOS 上。superwhisper 命令可以搜索和导出你的历史记录，编辑词汇，并控制正在运行的 App。

怎样安装 superwhisper CLI？

用 curl 运行它文档里的安装脚本。它会装到 /usr/local/bin，如果那里不可写，就装到 ~/.local/bin。

能从终端开始 superwhisper 录音吗？

能。superwhisper start、stop 和 record 可以控制录音，前提是 App 处于打开状态。

superwhisper 有 MCP 服务器吗？

有。superwhisper mcp 会通过 stdio 把 CLI 作为 MCP 服务器运行，提供搜索、历史记录、词汇和文本替换的工具。

superwhisper CLI 能在 Windows 上用吗？

不能。它的文档说 CLI 只支持 macOS。