Voicevox MCP

🚀 voicevox-mcp

本項目是一個與VOICEVOX引擎協同工作的MCP（Model Context Protocol）服務器，可實現語音合成以及獲取揚聲器信息。它採用TypeScript編寫，並運用了MCP SDK。

🚀 快速開始

環境準備

VOICEVOX引擎的啟動（推薦使用Docker）

docker compose up -d

執行上述命令後，VOICEVOX引擎將在localhost:50021啟動。

安裝依賴包並構建項目

npm install
npm run build 

配置Cursor

{
  "mcpServers": {
    "voicevox-mcp": {
      "command": "node",
      "args": ["${Path to Repository}/dist/index.js"],
      "env": {
        "SPEAKER_ID": 8,
        "SPEED_SCALE": 1.2,
        "VOICEVOX_API_URL": "http://localhost:50021" 
      }
    }
  }
}

可根據需要對VOICEVOX_API_URL進行設置。

使用說明

• 可通過MCP客戶端的speakers工具獲取揚聲器列表。
• 利用speak工具將文本合成為語音並在本地播放（由於使用了afplay命令，推薦在Mac環境下使用）。

✨ 主要特性

• 獲取VOICEVOX引擎的揚聲器信息（/speakers）。
• 使用指定的揚聲器將文本合成為語音並在本地播放（/speak），此功能僅支持Mac系統。

📦 安裝指南

啟動VOICEVOX引擎

docker compose up -d

安裝依賴並構建

npm install
npm run build 

💻 使用示例

基礎用法

在.cursor/mcp.json中進行如下配置：

{
  "mcpServers": {
    "voicevox-mcp": {
      "command": "node",
      "args": ["${Path to Repository}/dist/index.js"],
      "env": {
        "SPEAKER_ID": 8,
        "SPEED_SCALE": 1.2,
        "VOICEVOX_API_URL": "http://localhost:50021" 
      }
    }
  }
}

高級用法

可根據實際需求調整.cursor/mcp.json中的配置參數，例如修改SPEAKER_ID來選擇不同的揚聲器，調整SPEED_SCALE來改變語音播放速度等。

📚 詳細文檔

主要依賴包

• @modelcontextprotocol/sdk
• zod
• typescript

🔧 技術細節

本項目使用TypeScript實現了與VOICEVOX引擎的交互，藉助MCP SDK提供了語音合成和揚聲器信息獲取的功能。通過配置.cursor/mcp.json文件，可靈活調整項目的運行參數。

📄 許可證

本項目採用MIT許可證。

⚠️ 重要提示

• 若VOICEVOX引擎未在localhost:50021運行，則無法使用語音合成功能。
• 在非Mac環境下，請適當修改afplay部分的代碼。