Nijivoice

🚀 NijiVoice-MCP プロジェクトドキュメント

NijiVoice-MCPは、にじボイス APIのModel Context Protocol (MCP) バージョンを実装したものです。これを通じて、大規模言語モデル (LLM) がNijiVoice APIにアクセスし、テキストから音声への生成を簡単に実現できます。

🚀 クイックスタート

このプロジェクトは開発段階にあり、まだ全面的な検証を受けていません。本番環境での使用は避けてください！

✨ 主な機能

• NijiVoice APIを使用した音声合成
• 利用可能な声優情報の取得
• 残高の照会
• MCPインターフェースを介したLLMとの接続

📦 インストール

システム要件

• Python 3.12 以上
• NijiVoice API Key
• ネットワーク接続

インストール手順

# コードリポジトリをクローン
git clone https://github.com/YOUR_USERNAME/nijivoice-mcp.git
cd nijivoice-mcp

# 依存パッケージをインストール
pip install -e .

📚 ドキュメント

環境構成

1. .env ファイルを作成し、以下の内容を追加します。

NIJIVOICE_API_KEY=あなたのAPIキー
DEFAULT_VOICE_ACTOR_ID=デフォルトで使用する声優ID（オプション）
LOG_LEVEL=INFO

2. API KeyはNijiVoiceの公式サイトから取得できます。

MCPサーバーの起動

python main.py

起動後、MCPサーバーはLLMからのリクエストを待機します。

音声合成の例

LLM側からMCPサービスを呼び出す例：

# 利用可能な声優リストを取得
actors = await tools.call("actor/get_voice_actors")

# 音声を合成
voice_result = await tools.call("voice/generate_voice", {
    "script": "こんにちは、これはNijiVoiceのテストです。",
    "voice_actor_id": "90031163-c497-44f3-a8a6-e45e4d0cb8f6",  # 声優ID
    "speed": 1.0,
    "emotional_level": 0.5,
    "sound_duration": 0.1,
    "format": "mp3"
})

# 残高を照会
balance = await tools.call("credit/get_credit_balance")

利用可能なMCPツール

声優関連ツール

• actor/get_voice_actors(): すべての利用可能な声優情報を取得します。

音声合成ツール

• voice/generate_voice(): テキストを音声に変換します。

プロジェクト構造

nijivoice-mcp/
├── niji_mcp/
│   ├── __init__.py
│   ├── api.py          # API クライアントの実装
│   ├── exceptions.py   # 例外の定義
│   └── models.py       # データモデル
├── server.py           # MCP サーバーの実装
└── utils/              # ユーティリティ関数
    ├── __init__.py
    ├── audio_utils.py   # 音声処理ユーティリティ
    ├── error_handling.py# エラー処理ロジック
    └── retry_logic.py   # リトライメカニズム

テスト

# テストを実行
pytest

注意事項と既知の問題

1. 開発中のプロジェクト：機能と仕様は随時変更される可能性があります。
2. NijiVoice APIの変更リスク：APIが更新された場合、このプロジェクトが非互換になる可能性があります。
3. エラー処理の不足：一部のエラーシナリオの処理はまだ不完全です。
4. 長文生成のタイムアウト：長いテキストを処理する際にタイムアウトが発生する可能性があります。
5. 一部のレスポンス形式の未対応：NijiVoiceのすべてのAPIレスポンス形式を完全にサポートしていません。

トラブルシューティング

問題が発生した場合：

1. ログファイル nijivoice_mcp.log を確認します。
2. API Keyが正しく設定されていることを確認します。
3. ネットワーク接続の状態を確認します。
4. NijiVoice APIの稼働状況を確認します。

📄 ライセンス

このプロジェクトは MIT License に従います。

謝辞

FastMCP と Model Context Protocol を参考にし、NijiVoiceの音声合成技術を使用させていただきました。ありがとうございます。