Voice Mcp

io.github.forgemeshlabs由 GitHub 帳號 forgemeshlabs 發布v0.2.7更新於 Nov 3, 2026

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

已驗證STDIO僅桌面媒體與設計AI 與機器學習

概覽

AI 產生的概覽

本機 MCP 伺服器,透過按次付費的 x402 語音 API 將文字轉成 WAV 語音,提供 20 種聲音、10 種人格與 31 種語言。

可以做什麼
  • 列出語音目錄:聲音、人格、語言、價格級距、字元上限與語速/品質範圍
  • 以 31 種語言的标准聲音將文字合成語音
  • 以細緻的語速與品質控制產生語音
  • 產生 Storyteller、Narrator、Urgent 等具表現力的人格語音
  • 依 OpenAI 風格的請求(輸入、聲音、模型、回應格式)產生語音
  • 一次呼叫為最多 20 段文字批次產生音訊
適用情境
適合需要讓助理開口說話的情境:旁白、狀態播報、警示、品牌或角色聲音、展示,以及腳本化或批次音訊序列。建議先用免費的目錄工具挑選聲音並估算費用。
執行需求
以 stdio 方式在本機執行,透過 npm 套件 @forgemeshlabs/voice-mcp 安裝(需 Node.js),也可使用 Docker。需要一個持有 USDC 的 Base 主網錢包私鑰,透過 WALLET_PRIVATE_KEY 提供,因為每次產生呼叫都要付費。選用的 X402_MAX_PRICE_USD 與 X402_SESSION_BUDGET_USD 只能調降支出上限。需要連線至固定的後端位址。
安裝前請注意
伺服器會用 WALLET_PRIVATE_KEY 中的私鑰在 Base 上簽署 USDC 付款,請使用專用的低餘額錢包。每次產生呼叫都會花錢(約每次 0.005 至 0.01 美元),免費的目錄工具不收費。送出的文字會傳給第三方語音服務。內建上限會限制收款方、網路、資產與單次金額,選用預算變數只能再往下調。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Voice Mcp,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

Voice MCP

[M8ven Verified]

[npm version] [npm downloads] [License: MIT] [Node.js] [payments] [network] [mcpservers.org]

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.005Low-cost speech with 10 standard voices
generate_controlled_voice$0.005 / $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.005OpenAI-shaped /v1/audio/speech request
generate_batch_voices$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

bash
npm install -g @forgemeshlabs/voice-mcp

Docker

Build:

bash
docker build -t voice-mcp .

Run over stdio:

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

CMD arguments:

json
["node", "index.js"]

MCP Config

json
{  "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.

來源:README.md,提交 a5f423b

工具

6

list_voice_catalog

List Voice Catalog

Free discovery tool. Lists all 20 voices, 10 persona voices, 31 language codes, price buckets, character limits, and granular speed/quality controls before a paid voice generation call.

無需輸入參數。

generate_standard_voice

Generate Standard Voice

Generate low-cost WAV speech from text using one of 10 standard voices across 31 languages. Best for simple agent narration, status updates, alerts, and short spoken responses. Costs $0.005 for 501-2000 chars.

輸入參數langtext必填voice

generate_controlled_voice

Generate Controlled Voice

Generate WAV speech with granular controls for speed and quality. Use this when an agent needs faster, slower, clearer, more polished, or more deliberate delivery. Costs $0.005 for 1-500 chars or $0.006 for 501-2000 chars.

輸入參數langtext必填speedstepsvoice

generate_persona_voice

Generate Persona Voice

Generate expressive WAV speech with persona voices such as Storyteller, Narrator, Announcer, Assistant, Urgent, Sage, Spark, Anchor, Velvet, or Echo. Best for branded agents, characters, demos, stories, alerts, and premium user experiences. Costs $0.005 for 1-500 chars or $0.01 for 501-2000 chars.

輸入參數langtext必填speedstepsvoice

generate_openai_compatible_voice

Generate OpenAI-Compatible Voice

Generate speech using an OpenAI-shaped request with input, voice, model, and response_format fields. Use this for agents or apps already designed around /v1/audio/speech style payloads. Costs $0.005 for 501-2000 chars.

輸入參數input必填modelvoiceresponse_format

generate_batch_voices

Generate Batch Voices

Generate WAV audio for up to 20 text items in one paid call using standard voices. Best for queues, notifications, scripted sequences, content batches, and multi-step agent workflows. Costs $0.005 for 501-2000 total chars.

輸入參數items必填defaults

版本歷史

4
  1. v0.2.7最新Nov 3, 2026
  2. v0.2.6Nov 1, 2026
  3. v0.2.5Oct 8, 2026
  4. v0.2.2Sep 16, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分
  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分