MCP Make Sound

🚀 🔊 MCP Make Sound

このModel Context Protocol (MCP)サーバーは、macOSにおいて包括的な音声再生機能を提供します。AIアシスタントやその他のMCPクライアントが、システム音、テキスト読み上げ、カスタムオーディオファイルを再生し、豊かな音声フィードバックを得ることができます。

✨ 主な機能

• 🔔 シンプルな音声メソッド：事前に設定された情報、警告、エラー音
• 🎵 カスタムシステム音：macOSに組み込まれた14種類の音声を再生
• 🗣️ テキスト読み上げ：カスタマイズ可能な声でテキストを音声に変換
• 📁 ファイル再生：ディスクからカスタムオーディオファイルを再生
• 🚀 TypeScriptとMCP SDKで構築
• 🪶 軽量で統合が容易

📋 必要条件

• 🍎 macOS（afplayとシステム音を使用）
• 🟢 Node.js 18+
• 📝 TypeScript

📦 インストール

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

git clone <repository-url>
cd mcp-make-sound

2. 依存関係をインストールします：

npm install

3. プロジェクトをビルドします：

npm run build

💻 使用例

🎵 サーバーの起動

MCPサーバーを起動します：

npm start

自動リロードで開発する場合は：

npm run dev

🎯 例：WarpターミナルでのClaudeとの統合

以下は、WarpターミナルでAIタスクが完了したときに音声フィードバックを提供するようにMCP音声サーバーを設定する方法です：

設定ルール： 「AIが完了したら、mcp-make-soundを使用して音声を再生します。MCPはエラー、情報、成功をサポートしています。AIタスクの結果に基づいて適切な音声を再生します。」

この設定により、以下のことが可能になります：

• 🔔 タスクが正常に完了したときに心地よいチャイム音を聞く
• ⚠️ 警告または部分的な完了に対してアラート音を取得
• ❌ エラーまたは失敗に対して明確な音声フィードバックを受け取る

音声フィードバックにより、AIアシスタントがリクエストの処理を完了したときにすぐに知ることができるため、他の作業に集中することができます。

🛠️ 利用可能なツール

サーバーは4つのツールを提供します：

シンプルな音声メソッド（旧形式）

play_info_sound

• 説明：情報用のシステム音を再生
• パラメータ：なし
• 音声：Glass.aiff

play_warning_sound

• 説明：警告用のシステム音を再生
• パラメータ：なし
• 音声：Purr.aiff

play_error_sound

• 説明：エラー用のシステム音を再生
• パラメータ：なし
• 音声：Sosumi.aiff

高度な音声メソッド

play_sound

• 説明：カスタマイズ可能なパラメータでさまざまな種類の音声を再生
• パラメータ：
  • type（必須）："system"、"tts"、または"file"
  • タイプに基づく追加パラメータ（以下の例を参照）

基本的な使用法

システム音

macOSに組み込まれた14種類の音声のいずれかを再生します：

{
  "name": "play_sound",
  "arguments": {
    "type": "system",
    "name": "Basso"
  }
}

利用可能なシステム音： Basso、Blow、Bottle、Frog、Funk、Glass、Hero、Morse、Ping、Pop、Purr、Sosumi、Submarine、Tink

テキスト読み上げ

オプションで声を選択してテキストを音声に変換します：

{
  "name": "play_sound",
  "arguments": {
    "type": "tts",
    "text": "Hello, this is a test message",
    "voice": "Albert"
  }
}

声を指定しない場合（システムのデフォルトを使用）：

{
  "name": "play_sound",
  "arguments": {
    "type": "tts",
    "text": "Task completed successfully"
  }
}

サポートされる声：

• 英語：Albert、Alice、Bad News、Bahh、Bells、Boing、Bruce、Bubbles、Cellos、Daniel、Deranged、Fred、Good News、Hysterical、Junior、Kathy、Pipe Organ、Princess、Ralph、Trinoids、Whisper、Zarvox
• 国際：Anna、Amélie、Daria、Eddy、Fiona、Jorge、Juan、Luca、Marie、Moira、Nora、Rishi、Samantha、Serena、Tessa、Thomas、Veena、Victoria、Xander、Yelda、Zosia

注意：サポートされていない声が指定された場合、システムはデフォルトの声に切り替えて再生を続行します。

カスタムオーディオファイル

ディスクからオーディオファイルを再生します：

{
  "name": "play_sound",
  "arguments": {
    "type": "file",
    "path": "/Users/username/Music/notification.mp3"
  }
}

一般的なオーディオ形式をサポートします：.aiff、.wav、.mp3、.m4aなど。

🔒 セキュリティと制限事項

• システム音：14種類の公式macOS音声のみが許可されます
• テキスト読み上げ：
  • テキストは最大1000文字に制限されます
  • 声の検証が行われ、システムのデフォルトに切り替えられます
  • セキュリティ上、43種類以上のサポートされる声が選りすぐられています
• ファイル再生：絶対パスが必要で、ファイルの存在が検証されます

🔗 MCPクライアントとの統合

このサーバーは、以下のようなMCP互換クライアントと統合できます：

• 🤖 Claude Desktop
• 🛠️ カスタムMCPクライアント
• 🧠 MCPをサポートするAIアシスタント

MCP設定例

MCPクライアントの設定に以下を追加します：

{
  "mcp-make-sound": {
    "command": "node",
    "args": [
      "/Users/nocoo/Workspace/mcp-make-sound/dist/index.js"
    ],
    "env": {},
    "working_directory": "/Users/nocoo/Workspace/mcp-make-sound",
    "start_on_launch": true
  }
}

ツール呼び出しの例：

{
  "name": "play_info_sound",
  "arguments": {}
}

{
  "name": "play_sound",
  "arguments": {
    "type": "system",
    "name": "Hero"
  }
}

🛠️ 開発

📁 プロジェクト構造

mcp-make-sound/
├── src/
│   ├── index.ts          # メインサーバーの実装
│   └── __tests__/        # 単体テスト
│       └── sound.test.ts # 音声システムのテスト
├── dist/                 # コンパイルされたJavaScriptの出力
├── eslint.config.js      # ESLintの設定
├── vitest.config.ts      # Vitestのテスト設定
├── package.json          # プロジェクトの設定
├── tsconfig.json         # TypeScriptの設定
└── README.md            # このファイル

📜 スクリプト

ビルドと実行

• npm run build - 🔨 TypeScriptをJavaScriptにコンパイル
• npm start - ▶️ コンパイルされたサーバーを実行
• npm run dev - 🔄 自動再構築と再起動を伴う開発モード
• npm run kill - 🛑 実行中のすべてのMCPサーバーインスタンスを停止

コード品質とテスト

• npm run lint - 🔍 コードスタイルとエラーをチェック
• npm run lint:fix - 🔧 自動修正可能なリントエラーを修正
• npm run test - 🧪 ウォッチモードでテストを実行
• npm run test:run - ✅ テストを1回実行
• npm run test:ui - 🎛️ インタラクティブUIでテストを実行

⚙️ 動作原理

1. サーバーは公式SDKを使用してMCPプロトコルを実装します
2. 異なる音声機能のための4つのツールを公開します
3. ツールが呼び出されると、macOSコマンドを使用します：
   • オーディオファイルの再生（システム音とカスタムファイル）にはafplayを使用
   • テキスト読み上げ合成にはsayを使用
4. システム音は/System/Library/Sounds/にあります
5. サーバーは標準入出力（stdio）を介して通信します

🔧 技術詳細

• 🔌 トランスポート：標準入出力（stdio）
• 📡 プロトコル：Model Context Protocol (MCP)
• 🎧 オーディオバックエンド：macOSのafplayとsayコマンド
• 🎵 音声ファイル：システムの.aiffファイル、カスタムオーディオファイル、および合成音声

🚨 エラーハンドリング

サーバーには包括的なエラーハンドリングが含まれています：

• ツール名とパラメータを検証します
• afplayとsayコマンドの失敗を処理します
• 各音声タイプの必須パラメータを検証します
• 適切なエラーメッセージをクライアントに返します
• エラー時にサーバーを正常にシャットダウンします

📄 ライセンス

MIT License

🤝 コントリビューション

コントリビューションは大歓迎です！プルリクエストを送信してください。

🎼 音声機能

シンプルなメソッド（旧形式）

• 🔔 情報：Glass.aiff - 心地よいチャイム音
• ⚠️ 警告：Purr.aiff - 穏やかなアラート音
• ❌ エラー：Sosumi.aiff - 独特なエラー音

高度なメソッド（play_sound）

• 🎵 14種類のシステム音：すべての組み込みmacOS音声が利用可能
• 🗣️ 50種類以上のテキスト読み上げ声：複数の言語とキャラクターの声
• 📁 カスタムファイル：.aiff、.wav、.mp3、.m4aなどのサポート

これらの機能により、あらゆるアプリケーションのニーズに対応した豊富な音声フィードバックオプションが提供されます。