English Français العربية

io.github.forgemeshlabs/voice-mcp

السجل الرسمي الوسائط والتصميم

Give Your Agent A Voice: x402 pay-per-call speech with 20 voices, 10 personas, 31 languages.

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

التثبيت

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

NPM package @forgemeshlabs/voice-mcp
Claude Code 
claude mcp add voice-mcp -- npx -y @forgemeshlabs/voice-mcp@0.2.5
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "voice-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@forgemeshlabs/voice-mcp@0.2.5"
            ]
        }
    }
}

التوثيق

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

المحتويات
  1. Voice MCP
  2. Voice Coverage
  3. Voice Samples
  4. Tools
  5. Install
  6. Docker
  7. MCP Config
  8. Requirements and safety
  9. Notes

Voice MCP

Give Your Agent A Voice: x402 pay-per-call speech with 20 voices, 10 personas, 31 languages, granular speed and quality controls, OpenAI-shaped requests, and batch audio.

This MCP wraps https://voice.forgemesh.io, an x402 Voice API with standard voices, persona voices, OpenAI-shaped speech requests, 31 languages, speed controls, quality controls, and batch generation. Payments are made per call in USDC on Base.

Voice Coverage

  • 10 standard voices: M1-M5, F1-F5
  • 10 persona voices: Storyteller, Narrator, Announcer, Assistant, Urgent, Sage, Spark, Anchor, Velvet, Echo
  • 31 languages: en, ko, ja, ar, bg, cs, da, de, el, es, et, fi, fr, hi, hr, hu, id, it, lt, lv, nl, pl, pt, ro, ru, sk, sl, sv, tr, uk, vi
  • Granular control: speed 0.7x-2.0x, quality steps 1-100, persona selection, OpenAI-shaped audio format requests, and batch generation for up to 20 texts
  • Voice samples are generated on demand by the paid speech tools and returned as audio_base64 WAV output

Voice Samples

Tools

ToolPricePurpose
list_voice_catalogFreeVoices, personas, languages, pricing, buckets, and controls
generate_standard_voice$0.001 / $0.003Low-cost speech with 10 standard voices
generate_controlled_voice$0.003 / $0.006Speech with granular speed and quality controls
generate_persona_voice$0.005 / $0.01Storyteller, Velvet, Narrator, Announcer, Assistant, Urgent, and more
generate_openai_compatible_voice$0.001 / $0.003OpenAI-shaped /v1/audio/speech request
generate_batch_voices$0.002 / $0.005Up to 20 texts per call

Short prices apply to 1-500 characters. Long prices apply to 501-2000 characters.

The MCP validates voice names, language codes, audio formats, speed/quality ranges, batch item count, and character limits locally before making a paid x402 call.

Install

npm install -g @forgemeshlabs/voice-mcp

Docker

Build:

docker build -t voice-mcp .

Run over stdio:

docker run --rm -i \
  -e WALLET_PRIVATE_KEY=0x... \
  voice-mcp

CMD arguments:

["node", "index.js"]

MCP Config

{
  "mcpServers": {
    "voice": {
      "command": "voice-mcp",
      "env": {
        "WALLET_PRIVATE_KEY": "0x..."
      }
    }
  }
}

Requirements and safety

  • Use a dedicated, low-balance wallet; the server signs payments with WALLET_PRIVATE_KEY.
  • The server refuses to sign for any payee other than the ForgeMesh Voice wallet, any network other than Base mainnet, any asset other than USDC, or any amount over the built-in per-call cap ($0.01).
  • Optional env X402_MAX_PRICE_USD (per call) and X402_SESSION_BUDGET_USD (cumulative per process, default $10) can only LOWER the built-in caps.
  • The backend URL is fixed to https://voice.forgemesh.io; all requests are same-origin, time-limited (60s), size-capped (2 MB) and never follow redirects.

Notes

  • Paid tools require a Base wallet private key with USDC.
  • The server returns audio_base64 for audio tools so MCP clients can store, play, or forward the WAV bytes.
  • No API keys or subscriptions are required for the voice service itself.

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

ما هو io.github.forgemeshlabs/voice-mcp؟

Give Your Agent A Voice: x402 pay-per-call speech with 20 voices, 10 personas, 31 languages.

كيف أثبّت io.github.forgemeshlabs/voice-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add voice-mcp -- npx -y @forgemeshlabs/voice-mcp@0.2.5. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.forgemeshlabs/voice-mcp إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.forgemeshlabs/voice-mcp مفتوح المصدر؟

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

من يصون io.github.forgemeshlabs/voice-mcp؟

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

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