Aqua Voice

Cursor 用 Aqua Voice

Cursor と Grok Bot を Aqua Voice アカウントに接続します。保存されたディクテーションを検索し、文字起こしを読み、リモート MCP サーバーを通じて Aqua の設定を管理できます。

できること

• 保存された Aqua セッションを検索し、その文字起こしを読めます。
• 辞書、テキスト置換、カスタム指示を読み取り、更新できます。
• 言語を含む、対応している設定を読み取り、変更できます。
• リクエストに応じて、選択したディクテーションへのフィードバックや修正を送信できます。

履歴を利用できるかどうかは、Aqua のプライバシー設定によって異なります。この接続からアクセスできるのは、認証した Aqua アカウントのみです。マイク録音を開始したり、デスクトップでのディクテーションを操作したりすることはありません。フィードバックによって、別のアプリにすでに挿入されたテキストが置き換えられることはありません。

要件

• プラグインに対応した最新バージョンの Cursor。
• Aqua Voice アカウント。MCP へのアクセスはすべての Aqua プランで利用できます。
• 組織によって管理されている場合は、Cursor ワークスペースにプラグインをインストールする権限。

このプラグインは無料のオープンソースです。Aqua アカウントの料金は別途請求されます。このプラグインには購入やアップグレードのツールはありません。

ローカルにインストールする

Cline

同じホスト型 Aqua Voice MCP サーバーを Cline に接続するには、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 の言語をフランス語に設定してください。」

最後の 2 つの例では、Aqua アカウントが変更されます。ツール呼び出しを承認する前に、変更内容を確認してください。

トラブルシューティングと削除

• プラグインが表示されない： Cursor を再読み込みし、.cursor-plugin/plugin.json が ~/.cursor/plugins/local/aqua-voice 内にあることを確認してください。同じ名前のマーケットプレイス版がインストールされている場合、ローカル版より優先されます。
• 認証が必要です： Aqua MCP サーバーに再接続し、ブラウザーでのサインインと同意の手続きを完了してください。
• 保存済みの文字起こしがありません： aqua_get_me が返す history_available と Aqua のプライバシー設定を確認してください。利用できない履歴をこのプラグインで復元することはできません。
• 書き込みが拒否されます： 接続に付与された権限を確認し、求められた場合は再認証してください。
• プラグインを削除する： Cursor で Aqua サーバーの認証を切断またはクリアしてから、プラグインをアンインストールするか、ローカルのプラグインディレクトリを削除してください。ファイルを削除しただけでは、保存済みの OAuth 認証情報がクリアされない場合があります。

リンク

• Aqua MCP
• ツールのリファレンスと接続に関するドキュメント
• プライバシーポリシー
• Aqua の利用規約
• サポート
• Cursor プラグインのドキュメント

MCP Registry の掲載情報

server.json は、公式 MCP Registry に掲載する、io.github.aqua-voice/aqua-voice のホスト型 Aqua Voice MCP サーバーについて記述しています。このリポジトリにはクライアント設定と掲載用アセットが含まれていますが、ホスト型バックエンドのソースコードは含まれていません。

メンテナーは、このリポジトリの GitHub Actions ページで main を対象に Publish to MCP Registry を実行して、掲載情報を公開できます。このワークフローでは GitHub OIDC を使用するため、保存済みのレジストリトークンは不要です。新しい掲載バージョンを公開する前に、server.json のバージョンを更新してください。レジストリへの公開と Cursor Marketplace の審査は別々のプロセスです。

ライセンス

プラグインパッケージは MIT License の下で利用できます。Aqua Voice の名称とロゴは、それぞれの所有者の商標です。このライセンスは商標権を付与するものではありません。ホスト型 Aqua サービスには Aqua の利用規約が適用されます。