English Français العربية

WebVoice

السجل الرسمي الإنتاجية

WebVoice MCP: chat, TTS, STT, translate, images. Email signup, welcome credits, optional Solana.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

PYPI package webvoice-mcp
Claude Code 
claude mcp add webvoice -e 'WEBVOICE_API_KEY=<your webvoice_api_key>' -e 'WEBVOICE_BASE_URL=https://webvoice.easytaskflow.app/api/v1' -- uvx webvoice-mcp==0.2.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "webvoice": {
            "command": "uvx",
            "args": [
                "webvoice-mcp==0.2.1"
            ],
            "env": {
                "WEBVOICE_API_KEY": "<your webvoice_api_key>",
                "WEBVOICE_BASE_URL": "https://webvoice.easytaskflow.app/api/v1"
            }
        }
    }
}

متغيرات البيئة

  • WEBVOICE_API_KEY سري WebVoice API key (wv_…). Optional until after webvoice_register_verify; required for chat/TTS/STT.
  • WEBVOICE_BASE_URL REST API base URL

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. WebVoice MCP Server
  2. Configure Cursor
  3. Tools
  4. Example agent flow

WebVoice MCP Server

Local Model Context Protocol server that exposes WebVoice REST API tools to Cursor, Claude Desktop, and other MCP clients.

Install from PyPI:

pip install webvoice-mcp
From source (development)
pip install -r requirements-mcp.txt
# or editable install from repo root:
pip install -e .

Configure Cursor

Option A — Agent registration via MCP (no browser)
  1. Add MCP without WEBVOICE_API_KEY first (or use the register tools from any client).
  2. Call webvoice_register_send_code with your email.
  3. Read the OTP from email, then webvoice_register_verify with the code.
  4. Response includes api_key (once), onboarding.credits, onboarding.can_use_api, and optional onboarding.solana (wallet + memo_code for USDC/SOL top-up).
  5. If can_use_api is true, use chat/TTS/STT immediately with welcome credits.
  6. Set WEBVOICE_API_KEY in MCP config and restart Cursor (optional Solana/PayPal top-up later).

REST equivalent: POST /api/v1/auth/send-code/ → POST /api/v1/auth/verify-code/ with create_api_key: true. See API docs.

Option B — Browser signup (human)
  1. Login — email OTP or Google (/accounts/login/). New users get welcome + daily free credits.
  2. API key — API dashboard → Create key → copy wv_… (shown once).
  3. Credits (optional) — Buy credits, Premium (PayPal), or Solana (send USDC/SOL with your personal memo from webvoice_onboarding).

When balance is zero, MCP calls fail with insufficient credits; you receive an email with a recharge link.

MCP config

Edit Cursor MCP config (~/.cursor/mcp.json or Settings → MCP):

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

If webvoice-mcp is not on PATH, use Python module form:

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

Optional: WEBVOICE_BASE_URL (default https://webvoice.easytaskflow.app/api/v1).

Tools

ToolDescription
webvoice_register_send_codeStart registration — OTP to email
webvoice_register_verifyComplete registration → API key + onboarding (credits, can_use_api)
webvoice_onboardingCredits, can_use_api, optional Solana wallet/memo, recharge URLs
webvoice_statusCredits balance
webvoice_list_chat_modelsAvailable chat models
webvoice_list_voicesTTS voices
webvoice_chatChat completions (DeepSeek default)
webvoice_ttsText-to-speech → MP3
webvoice_sttTranscribe local audio file
webvoice_translateText translation
webvoice_imageMiniMax image generation

Example agent flow

New agent (register → use → optional top-up):

  1. webvoice_register_send_code → webvoice_register_verify → save api_key.
  2. If onboarding.can_use_api: call webvoice_chat / webvoice_tts / … immediately.
  3. Optional: webvoice_onboarding → Solana memo or PayPal URLs when you need more credits.

Existing account:

  1. Ask the model to call webvoice_chat with your question.
  2. Call webvoice_tts with output_path to save spoken reply.
  3. Call webvoice_stt with a recorded audio_path for voice input.

Credits are billed on your WebVoice account per API call.

الأسئلة الشائعة

ما هو WebVoice؟

WebVoice MCP: chat, TTS, STT, translate, images. Email signup, welcome credits, optional Solana.

كيف أثبّت WebVoice؟

يعمل على جهازك. في Claude Code: claude mcp add webvoice -e 'WEBVOICE_API_KEY=<your webvoice_api_key>' -e 'WEBVOICE_BASE_URL=https://webvoice.easytaskflow.app/api/v1' -- uvx webvoice-mcp==0.2.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج WebVoice إلى مفتاح API؟

نعم. يتطلب WEBVOICE_API_KEY، وتضبطها في إعداداته.

هل WebVoice مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون WebVoice؟

ينشره supermarco74. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.