MCP Play Sound Server

Name: MCP Play Sound Server
Author: davidteren

@davidteren

MCP Play Sound Server について

Model Context Protocol server that provides audio playback functionality for AI agents. Play notification sounds when coding tasks complete. Early version/proof of concept - macOS only.

基本情報

カテゴリ

その他

ライセンス

MIT license

ランタイム

python

トランスポート

stdio

公開者

davidteren

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "play-sound-mcp-server": {
      "command": "python",
      "args": [
        "-m",
        "venv",
        ".venv"
      ]
    }
  }
}

ツール

ツールは検出されませんでした

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

What is MCP Play Sound Server?

MCP Play Sound Server is a Model Context Protocol server that provides audio playback for AI agents, enabling them to play sound notifications when coding tasks are completed. It is currently tested on macOS and is an early proof of concept.

How to use MCP Play Sound Server?

Clone the repository, set up a Python virtual environment, and install the package with pip install -e ".[dev]". Then configure Claude Desktop by adding a JSON entry to claude_desktop_config.json with the command uv and appropriate args pointing to the server directory. Restart Claude Desktop and ask the assistant to play a notification sound.

Key features of MCP Play Sound Server

Plays audio notifications when AI tasks complete
Bundled default sound for immediate use
Supports custom audio files (WAV, MP3, FLAC, OGG, M4A)
Automatically falls back to default sound if custom audio fails
Works on macOS using AFPlay and SimpleAudio
Configurable volume level and audio output device

Use cases of MCP Play Sound Server

Alert the user when a long-running coding task finishes
Play a custom sound to indicate an error or milestone
Test audio playback and list available system devices
Integrate audio feedback into AI‑assisted development workflows

FAQ from MCP Play Sound Server

Is this server compatible with Windows or Linux?

No, it is currently tested only on macOS. Future versions may support additional platforms.

What audio formats are supported for custom sound files?

Custom audio files can be in WAV, MP3, FLAC, OGG, or M4A format.

How can I set a custom sound to play?

Set the CUSTOM_SOUND_PATH environment variable or pass the custom_sound_path parameter when calling the play_notification_sound tool.

How do I control the playback volume?

Set the VOLUME_LEVEL environment variable to a value between 0.0 and 1.0; the default is 0.8.

What happens if a custom sound file cannot be played?

The server automatically falls back to the default bundled sound if the custom audio fails.

「その他」の他のコンテンツ

MCP Registry

modelcontextprotocol

A community driven registry service for Model Context Protocol (MCP) servers.

7.0K

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K