Aqua Voice

Cursor 中的 Aqua Voice

将 Cursor 和 Grok Bot 连接到你的 Aqua Voice 账户。通过远程 MCP 服务搜索已存储的听写内容、阅读转录文本，并管理你的 Aqua 偏好设置。

你可以做什么

• 搜索已存储的 Aqua 会话并阅读其转录文本。
• 查看和更新词典、文本替换内容及自定义指令。
• 查看和更改支持的设置，包括语言。
• 根据你的请求，为选定的听写内容发送反馈或更正。

历史记录是否可用取决于你的 Aqua 隐私设置。此连接仅访问你授权的 Aqua 账户，不会启动麦克风录音或控制桌面听写。反馈不会替换已插入其他应用的文本。

要求

• 支持插件的最新版本 Cursor。
• Aqua Voice 账户。所有 Aqua 套餐均可使用 MCP。
• 如果 Cursor 工作区由组织管理，你需要获得安装插件的权限。

此插件免费且开源。Aqua 账户费用另行处理；此插件不提供购买或升级工具。

本地安装

Cline

如需在 Cline 中连接同一个托管的 Aqua Voice MCP 服务，请按照 Cline 安装指南操作。Cline 使用 Streamable HTTP 和 Aqua OAuth；无需本地服务。Cline 市场徽标可在此获取 400×400 PNG 图片。

Cursor

如需使用现有检出版本，请在 Cursor 中打开 Customize → Add → From Local Repository，然后选择此仓库的目录。附带的市场清单会显示 Aqua Voice 插件，供你安装。

在市场列表获批之前，请将此仓库克隆到 Cursor 的本地插件目录：

mkdir -p ~/.cursor/plugins/local
git clone https://github.com/aqua-voice/aqua-cursor-plugin.git ~/.cursor/plugins/local/aqua-voice

重启 Cursor 或运行 Developer: Reload Window。打开 Customize，确认 Aqua Voice 插件及其 aqua-voice MCP 服务已显示。企业工作区可能需要管理员启用本地插件导入。测试时请复制整个目录；Cursor 不会加载目标位于本地插件目录之外的本地插件符号链接。

连接账户

1. 在 Cursor 的 MCP 控件中打开 Aqua MCP 服务，并选择登录或身份验证操作。
2. 登录 Aqua 并检查请求的权限。客户端可能会同时请求读写权限。
3. 提问：“调用 aqua_get_me，并显示已连接的 Aqua 账户以及存储的历史记录是否可用。”

此插件通过 Streamable HTTP 连接到 https://api.aquavoice.com/mcp。OAuth 发现、动态客户端注册和 PKCE 负责处理登录。无需 API 密钥、客户端密钥、本地服务或安装软件包。如果写入操作需要额外授权，请先完成授权提示，再重试。

试试看

• “查找我最近与发布计划相关的 Aqua 听写内容。”
• “总结我选中的听写内容的转录文本。”
• “显示我的 Aqua 词典和文本替换内容。”
• “将此项目的名称添加到我的 Aqua 词典。”
• “将我的 Aqua 语言设置为法语。”

最后两个示例会更改你的 Aqua 账户。请先检查拟议的更改，再批准工具调用。

故障排查与移除

• 未显示插件： 重新加载 Cursor，并检查 .cursor-plugin/plugin.json 是否位于 ~/.cursor/plugins/local/aqua-voice 中。同名的 Marketplace 安装会优先于本地副本。
• 需要身份验证： 重新连接 Aqua MCP 服务，并完成浏览器登录和授权流程。
• 没有已存储的转录记录： 检查 aqua_get_me 返回的 history_available 和 Aqua 隐私设置。此插件无法重建不可用的历史记录。
• 写入遭到拒绝： 检查授予连接的权限，并在提示时重新授权。
• 移除插件： 在 Cursor 中断开连接／清除 Aqua 服务的身份验证，然后卸载插件或移除其本地插件目录。仅删除文件不一定会清除已保存的 OAuth 凭据。

链接

• Aqua MCP
• 工具参考和连接文档
• 隐私政策
• Aqua 条款
• 支持
• Cursor 插件文档

MCP Registry 列表

server.json 描述了托管的 Aqua Voice MCP 服务，用于官方 MCP Registry，标识为 io.github.aqua-voice/aqua-voice。此仓库包含客户端配置和列表资源；不包含托管后端的源代码。

维护者可以在此仓库的 GitHub Actions 页面中，从 main 运行 Publish to MCP Registry 来发布列表。此工作流使用 GitHub OIDC，无需保存 Registry 令牌。发布新版本的列表前，请更新 server.json 中的版本。Registry 发布和 Cursor Marketplace 审核是两个独立流程。

许可证

此插件包采用 MIT License。Aqua Voice 名称和徽标仍是各自所有者的商标；许可证不授予商标权。托管的 Aqua 服务受 Aqua 条款约束。