NijiVoice MCP

FastMCPを使用したにじボイスAPIのMCPサーバー実装です。

概要

このMCPサーバーは、にじボイスAPIを利用して音声合成を行うための機能を提供します。主な機能は以下の通りです：

• 利用可能な声優（Voice Actor）の一覧取得

• テキストから音声ファイルを生成

• クレジット残高の確認

Related MCP server: Audio Transcriber MCP Server

前提条件

• Python 3.12以上

• uv - 高速なPythonパッケージマネージャーとインストーラー

• fastmcp v2.2.8以上

• にじボイスAPIのAPIキー

インストール方法

1. リポジトリをクローンします：

   git clone https://github.com/ryoooo/nijivoice-mcp-beta.git
   cd nijivoice-mcp-beta

2. uv を使用して仮想環境を作成して依存関係をインストールします：

   uv venv
   source .venv/bin/activate  # Linux/Mac
   # または
   .venv\Scripts\activate  # Windows
   
   uv pip install -e .

3. .envファイルを作成し、にじボイスAPIのキーを設定します：

   NIJIVOICE_API_KEY=your_api_key_here

使い方

MCPサーバーの起動

開発モードでサーバーを起動するには：

uv run fastmcp dev server.py

本番モードでサーバーを起動するには：

uv run fastmcp run server.py

インストールして使用

MCPサーバーをインストールして使用するには：

uv run fastmcp install server.py

機能

以下の機能が利用可能です：

ツール（Tools）

• get_voice_actors(): 利用可能な声優の一覧を取得

• generate_voice(script, actor_id, speed, emotional_level, sound_duration, format): 音声を生成

• get_credit_balance(): クレジット残高を取得

リソース（Resources）

• voice-actors://list: 声優一覧リソース

• voice-actors://{actor_id}: 特定の声優の情報を取得

• credit://balance: クレジット残高リソース

プロンプト（Prompt）

• voice_generation_prompt(): 音声生成に関するプロンプトを提供

音声生成パラメータ

音声生成時に以下のパラメータを指定できます：

• script: 読み上げるテキスト（最大3,000文字）（必須）

• actor_id: 使用する声優のID（省略時は最初の声優を使用）

• speed: 読み上げスピード（0.4～3.0、デフォルト: 1.0）

• emotional_level: 感情レベル（0.0～1.5、デフォルト: -1.0 = 声優のデフォルト設定を使用）

• sound_duration: 音素発音の長さ（0.0～1.7、デフォルト: -1.0 = 声優のデフォルト設定を使用）

• format: 音声フォーマット（"mp3"または"wav"、デフォルト: "mp3"）

レスポンス形式

音声生成時のレスポンス形式は以下の通りです：

{
  "generatedVoice": {
    "audioFileUrl": "音声再生用のURL",
    "audioFileDownloadUrl": "音声ダウンロード用のURL",
    "duration": 1312, // 音声の長さ（ミリ秒）
    "remainingCredits": 3613 // 生成後の残りクレジット
  }
}

テスト

テストを実行するには：

uv run pytest

詳細なテスト結果を表示するには：

uv run pytest -v

カバレッジレポートを生成するには：

uv run pytest --cov=nijivoice

ライセンス

MIT

謝辞

• fastmcp - MCP (Model Context Protocol) サーバーを構築するためのPythonフレームワーク

• にじボイスAPI - 高品質な音声合成を提供するAPI