Aivisspeech

🚀 AivisSpeech MCP サーバー

AivisSpeech 音声合成用の Model Context Protocol (MCP) サーバーの実装です。このサーバーは AivisSpeech エンジンと連動し、音声合成のインターフェースを提供します。MCP プロトコルを通じて、AI アシスタントなどのアプリケーションは AivisSpeech の音声合成機能を簡単に利用できます。

✨ 主な機能

AivisSpeech MCP サーバーは以下の機能を提供します：

• MCP プロトコルに準拠した API エンドポイント
• 高品質な音声合成（AivisSpeech エンジンを通じて）
• TypeScript による型安全な設計
• 簡単な設定と高い拡張性のあるアーキテクチャ

📦 インストール

必要条件

• Node.js 18.x 以上
• npm 9.x 以上
• AivisSpeech エンジン（別途インストールが必要）

インストール手順

# リポジトリをクローン
git clone https://github.com/kentaro/aivis-speech-mcp.git
cd aivis-speech-mcp

# 依存関係のインストール
npm install

# ビルド
npm run build

# 環境変数の設定
cp .env.sample .env
# .envファイルを編集して、必要な設定を行ってください

# Cursor MCPの設定
cp .cursor/mcp.json.sample .cursor/mcp.json
# mcp.jsonファイル内の"/path/to/aivis-speech-mcp/dist/index.js"を
# 実際のプロジェクトパスに書き換えてください
# 例: "C:/Users/username/path/to/aivis-speech-mcp/dist/index.js"

環境設定

.env ファイルで以下の設定を行います：

# AivisSpeech API Configuration
AIVIS_SPEECH_API_URL=http://localhost:10086  # 示例地址，需根据实际情况修改
AIVIS_SPEECH_API_KEY=your_api_key_here      # 替换为实际的API密钥

# 其他配置（如有）
SAMPLE_TEXT=hello                            # 示例文本

💻 使用例

基本的な使用法

1. 依存関係のインストール：npm install を実行して必要なモジュールをインストールします。
2. 環境設定：.env ファイルを編集し、正しい API アドレスとキーを記入します。
3. プロジェクトのビルド：npm run build を実行してビルドします。
4. サービスの起動：npm start を実行してサーバーを起動します。

サンプルコマンド

# 依存関係のインストール
npm install

# プロジェクトのビルド
npm run build

# サーバーの起動
npm start

🔧 技術詳細

アーキテクチャ

• フロントエンド：ユーザーのリクエストを受け取り、結果を表示します。
• バックエンド：ビジネスロジックを処理し、AivisSpeech エンジンと通信します。
• エンジン：音声合成サービスを提供します。

API 仕様

リクエスト形式

{
  "text": "hello world",
  "speaker_id": "1",
  "format": "wav"
}

レスポンス形式

{
  "audio_url": "http://example.com/audio.wav",
  "duration": 3.5
}

MCP プロトコル連携

MCP プロトコルを通じて、AI アシスタントとのシームレスな接続を実現します。具体的な手順は以下の通りです：

1. サービスの登録：MCP センターに音声合成サービスを登録します。
2. パラメータの設定：関連するパラメータ（音程、速度など）を設定します。
3. リクエストの処理：MCP からの合成リクエストを受け取り、処理します。

トラブルシューティング

一般的な問題と解決策

• AivisSpeech エンジンに接続できない場合：

  • .env ファイル内の AIVIS_SPEECH_API_URL が正しいか確認してください。
  • エンジンが起動しており、ネットワークが正常であることを確認してください。

• 音声が再生されない場合：

  • システムの音声設定を確認し、正しいオーディオデバイスが選択されていることを確認してください。
  • 生成されたオーディオファイルのパスと権限が正しいことを確認してください。

• speaker_id が無効な場合：

  • AivisSpeech エンジン内に該当する speaker_id が存在することを確認してください。
  • エンジンのドキュメントを参照して、利用可能な speaker ID のリストを取得してください。

コントリビューション

GitHub の Issue Tracker を通じて、問題や機能要求を送信することを歓迎します。また、Pull Request も大歓迎です！

📄 ライセンス

MIT

謝辞

• AivisSpeech エンジンチーム
• Model Context Protocol 開発者