play-sound-mcp-server

ローカルのサウンドファイルを再生するMCPサーバーです

⚠️ 本サーバーは afplay コマンドを利用するため、macOS環境でのみ利用可能 です。

セットアップ

npm install
npm run build

サーバーの起動と使い方

サウンドファイルの指定

サーバー起動時の第1引数で再生したいファイル名（soundsディレクトリ内）を指定できます。指定しない場合は sound.mp3 が再生されます。

例: sounds/alert.mp3 を再生したい場合

node build/index.js alert.mp3

デフォルト（sound.mp3）を再生する場合:

node build/index.js

※ サウンドファイルは sounds/ ディレクトリに配置してください。

提供ツール情報

tool名: play-local-sound
説明: 指定したローカルのサウンドファイル（デフォルト: sound.mp3）をafplayで再生します。
引数: なし（サーバー起動時の引数でファイル名を指定）
戻り値: 再生結果のテキストメッセージ

MCPサーバーの設定例

MCPクライアントで以下のように設定してください(下記はVSCodeのsettings.jsonの例です):

{
  "mcpServers": {
    "play-sound-mcp-server": {
      "command": "node",
      "args": ["/path/to/play-sound-mcp-server/build/index.js", "custom.mp3"]
    }
  },
  "github.copilot.chat.codeGeneration.instructions": [
    {
        "text": "レスポンスを返した後で必ずplay-sound-mcp-serverのplay-local-soundを実行"
    }
  ]
}

参考

備考

デフォルトの sound.mp3 は TAM Music Factory の素材を利用しています。

ライセンス

本リポジトリのソースコードは MIT ライセンスで提供します。

デフォルト音源（sound.mp3）は TAM Music Factory の利用規約に従ってご利用ください。

サーバーの起動と使い方

サウンドファイルの指定