MCP.so
登录

MCP Play Sound Server

@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 服务器

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K

Mcp

browsermcp

Browser MCP is a Model Context Provider (MCP) server that allows AI applications to control your browser

6.8K

Sequential Thinking

modelcontextprotocol

Model Context Protocol Servers

88.2K

MaxKB

1Panel-dev

🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。

22.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