play-sound-mcp-server

PetitBaguette/play-sound-mcp-server

3.2

If you are the rightful owner of play-sound-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

This is a sample MCP server that plays local sound files using the @modelcontextprotocol/sdk, specifically designed for macOS environments.

Tools

  1. play-local-sound

    Plays a specified local sound file (default: sound.mp3) using afplay.

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 の利用規約に従ってご利用ください。