MCP ExplorerExplorer

Voicevox Mcp

@Yuki10Kobayashion a month ago
1 MIT
FreeCommunity
AI Systems
Voicevox MCP Server

Overview

What is Voicevox Mcp

voicevox-mcp is a Model Context Protocol (MCP) server that integrates with the VOICEVOX engine to enable voice synthesis and retrieval of speaker information. It is implemented in TypeScript and utilizes the MCP SDK.

Use cases

Use cases for voicevox-mcp include creating interactive voice applications, enhancing user experience in games with voiceovers, and developing tools for accessibility that convert text to speech.

How to use

To use voicevox-mcp, set up the VOICEVOX engine using Docker, then install the necessary dependencies and build the project. Configure the MCP client to connect to the server and use the ‘speakers’ tool to retrieve speaker lists and the ‘speak’ tool to synthesize text into speech.

Key features

Key features include the ability to retrieve speaker information from the VOICEVOX engine and synthesize speech from text using a specified speaker. Currently, local playback is supported only on Mac systems.

Where to use

voicevox-mcp can be used in various fields such as game development, virtual assistants, and any application requiring voice synthesis capabilities.

Content

voicevox-mcp

このプロジェクトは、VOICEVOXエンジンと連携して音声合成やスピーカー情報の取得ができるMCP(Model Context Protocol)サーバーです。TypeScriptで実装されており、MCP SDKを利用しています。

VOICEVOX Server MCP server

機能

  • VOICEVOXエンジンのスピーカー情報取得(/speakers)
  • 指定したスピーカーでテキストを音声合成し、ローカルで再生(/speak)
    • Macのみ対応

セットアップ

VOICEVOXエンジンの起動(Docker推奨)

docker compose up -d

これで localhost:50021 でVOICEVOXエンジンが起動します。

依存パッケージのインストール & ビルド

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環境推奨)。

主な依存パッケージ

  • @modelcontextprotocol/sdk
  • zod
  • typescript

注意事項

  • 今後改善
    • VOICEVOXエンジンが localhost:50021 で動作していないと音声合成は利用できません。
    • Mac以外の環境では afplay の部分を適宜変更してください。

ライセンス

MIT License

Tools

No tools

Comments

Recommend MCP Servers

View All MCP Servers