WebVoice

WebVoice MCP サーバー

Cursor、Claude Desktop、その他の MCP クライアントに WebVoice REST API ツールを公開するローカルのModel Context Protocolサーバーです。

PyPI からインストール：

pip install webvoice-mcp

ソースから（開発用）

pip install -r requirements-mcp.txt
# or editable install from repo root:
pip install -e .

Cursor の設定

オプション A — MCP 経由でエージェントを登録（ブラウザー不要）

1. まず WEBVOICE_API_KEY なしで MCP を追加します（または、任意のクライアントから登録ツールを使用します）。
2. メールアドレスを指定して webvoice_register_send_code を呼び出します。
3. メールで OTP を確認し、コードを指定して webvoice_register_verify を呼び出します。
4. レスポンスには api_key（一度のみ）、onboarding.credits、onboarding.can_use_api、および任意の onboarding.solana（USDC/SOL のチャージ用ウォレットと memo_code）が含まれます。
5. can_use_api が true の場合、ウェルカムクレジットですぐにチャット／TTS／STT を利用できます。
6. MCP 設定に WEBVOICE_API_KEY を設定し、Cursor を再起動します（Solana／PayPal によるチャージは後からでも可能です）。

REST での同等の操作：POST /api/v1/auth/send-code/ → create_api_key: true を指定して POST /api/v1/auth/verify-code/ を実行します。API ドキュメントを参照してください。

オプション B — ブラウザーで登録（人間向け）

1. ログイン — メールの OTP または Google を使用します（/accounts/login/）。新規ユーザーにはウェルカムクレジットと毎日の無料クレジットが付与されます。
2. API キー — API ダッシュボード → キーを作成 → wv_… をコピーします（一度のみ表示）。
3. クレジット（任意） — クレジットを購入、プレミアム（PayPal）、または Solana（webvoice_onboarding から取得した個人用メモを付けて USDC/SOL を送金）を利用します。

残高がゼロの場合、MCP の呼び出しはクレジット不足で失敗し、チャージ用リンクが記載されたメールが届きます。

MCP 設定

Cursor の MCP 設定（~/.cursor/mcp.json または Settings → MCP）を編集します。

{
  "mcpServers": {
    "webvoice": {
      "command": "webvoice-mcp",
      "env": {
        "WEBVOICE_API_KEY": "wv_your_key_here"
      }
    }
  }
}

webvoice-mcp が PATH にない場合は、Python モジュール形式を使用します。

{
  "mcpServers": {
    "webvoice": {
      "command": "python",
      "args": ["-m", "webvoice_mcp"],
      "cwd": "/path/to/webvoice",
      "env": {
        "WEBVOICE_API_KEY": "wv_your_key_here"
      }
    }
  }
}

任意：WEBVOICE_BASE_URL（デフォルトは https://webvoice.easytaskflow.app/api/v1）。

ツール

ツール	説明
webvoice_register_send_code	登録を開始 — メールに OTP を送信
webvoice_register_verify	登録を完了 → API キーとオンボーディング情報（クレジット、can_use_api）を取得
webvoice_onboarding	クレジット、can_use_api、任意の Solana ウォレット／メモ、チャージ用 URL
webvoice_status	クレジット残高
webvoice_list_chat_models	利用可能なチャットモデル
webvoice_list_voices	TTS 音声
webvoice_chat	チャット補完（デフォルトは DeepSeek）
webvoice_tts	テキスト読み上げ → MP3
webvoice_stt	ローカルの音声ファイルを文字起こし
webvoice_translate	テキスト翻訳
webvoice_image	MiniMax による画像生成

エージェントのフロー例

新規エージェント（登録 → 利用 → 必要に応じてチャージ）：

1. webvoice_register_send_code → webvoice_register_verify を実行し、api_key を保存します。
2. onboarding.can_use_api が true の場合、すぐに webvoice_chat / webvoice_tts / … を呼び出します。
3. 任意：さらにクレジットが必要になったら webvoice_onboarding を呼び出し、Solana のメモまたは PayPal の URL を確認します。

既存アカウント：

1. 質問を添えて webvoice_chat を呼び出すようモデルに依頼します。
2. output_path を指定して webvoice_tts を呼び出し、読み上げた応答を保存します。
3. 録音した音声を入力するには、audio_path を指定して webvoice_stt を呼び出します。

クレジットは API 呼び出しごとに WebVoice アカウントに請求されます。