AivisSpeech MCP サーバー

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

概要

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

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

必要条件

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

インストール

# リポジトリをクローン
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:10101  # AivisSpeech EngineのAPIエンドポイント

# Speaker Configuration
AIVIS_SPEECH_SPEAKER_ID=888753760  # デフォルトのスピーカーID

Cursor MCP設定

`.cursor/mcp.json`ファイルで以下の設定を行います：

{
  "mcpServers": {
    "AivisSpeech-MCP": {
      "command": "node",
      "args": ["/path/to/aivis-speech-mcp/dist/index.js"]
    }
  }
}

`/path/to/aivis-speech-mcp/dist/index.js`を、実際のプロジェクトのパスに書き換えてください。

Windowsの場合は、バックスラッシュをエスケープするか、フォワードスラッシュを使用してください。

例: `"C:/Users/username/path/to/aivis-speech-mcp/dist/index.js"`

使い方

開発モード

開発中は以下のコマンドでホットリロード機能付きでサーバーを起動できます：

npm run dev

ビルド

本番環境用にビルドする場合は以下のコマンドを実行します：

npm run build

本番モード

ビルド後、以下のコマンドで本番モードでサーバーを起動します：

npm start

テスト

テストを実行するには以下のコマンドを使用します：

npm test

アーキテクチャ

AivisSpeech MCP サーバーは以下のコンポーネントで構成されています：

• MCPサービス: Model Context Protocolに準拠したサーバーを提供し、クライアントからのリクエストを処理します
• AivisSpeech サービス: AivisSpeech EngineのAPIと通信し、音声合成を実行します

API仕様

MCPプロトコルに準拠したAPIエンドポイントを提供します。主な機能は以下の通りです：

• 音声合成（テキストから音声を生成）
• スピーカー情報の取得
• 音声スタイルの設定

詳細なAPI仕様についてはAivisSpeech Engine API仕様を参照してください。

MCPプロトコルとの連携

このサーバーは、Model Context Protocol（MCP）を実装しており、AIアシスタントなどのアプリケーションからシームレスに利用できます。MCPプロトコルについての詳細はMCP公式ドキュメントを参照してください。

トラブルシューティング

よくある問題と解決策：

• AivisSpeech Engineに接続できない: `.env`ファイルの`AIVIS_SPEECH_API_URL`が正しく設定されているか確認してください
• 音声が再生されない: システムの音声設定を確認し、適切なオーディオデバイスが選択されているか確認してください
• スピーカーIDが見つからない: AivisSpeech Engineが正しく起動しているか確認し、利用可能なスピーカーIDを確認してください

貢献

バグ報告や機能リクエストは、GitHubのIssueトラッカーを通じてお願いします。プルリクエストも歓迎します。

ライセンス

MIT

謝辞

• AivisSpeech Engineチーム
• Model Context Protocolの開発者