MCP Make Sound

🔊 MCP Make Sound

A Model Context Protocol (MCP) server that provides system sound playback capabilities for macOS. This server allows AI assistants and other MCP clients to play different types of system sounds for audio feedback.

✨ Features

🔔 Play Info Sound: Plays the "Glass" system sound for informational notifications
⚠️ Play Warning Sound: Plays the "Purr" system sound for warnings
❌ Play Error Sound: Plays the "Sosumi" system sound for errors
🚀 Built with TypeScript and the MCP SDK
🪶 Lightweight and easy to integrate

📋 Requirements

🍎 macOS (uses afplay and system sounds)
🟢 Node.js 18+
📝 TypeScript

🚀 Installation

Clone this repository:

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

Install dependencies:

npm install

Build the project:

npm run build

💡 Usage

🎵 Running the Server

Start the MCP server:

npm start

For development with auto-reload:

npm run dev

🎯 Example: Claude Integration with Warp Terminal

Here's how you can set up the MCP sound server to provide audio feedback when AI tasks complete in Warp terminal:

Warp Terminal Integration

Configuration Rule: "When AI is done, use mcp-make-sound to play a sound. The MCP supports error, info and success. Play the right sound based on AI task outcome."

This setup allows you to:

🔔 Hear a pleasant chime when tasks complete successfully
⚠️ Get an alert sound for warnings or partial completions
❌ Receive clear audio feedback for errors or failures

The audio feedback helps you stay focused on other work while knowing immediately when your AI assistant has finished processing your requests.

🛠️ Available Tools

The server provides three tools:

`play_info_sound`

Description: Play an informational system sound
Parameters: None
Sound: Glass.aiff

`play_warning_sound`

Description: Play a warning system sound
Parameters: None
Sound: Purr.aiff

`play_error_sound`

Description: Play an error system sound
Parameters: None
Sound: Sosumi.aiff

🔗 Integration with MCP Clients

This server can be integrated with any MCP-compatible client, such as:

🤖 Claude Desktop
🛠️ Custom MCP clients
🧠 AI assistants that support MCP

Example tool call:

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

🛠️ Development

📁 Project Structure

mcp-make-sound/
├── src/
│   └── index.ts          # Main server implementation
├── dist/                 # Compiled JavaScript output
├── package.json          # Project configuration
├── tsconfig.json         # TypeScript configuration
└── README.md            # This file

📜 Scripts

npm run build - 🔨 Compile TypeScript to JavaScript
npm start - ▶️ Run the compiled server
npm run dev - 🔄 Development mode with auto-rebuild and restart

⚙️ How It Works

The server implements the MCP protocol using the official SDK
It exposes three tools for different sound types
When a tool is called, it uses macOS's afplay command to play system sounds
Sounds are located in /System/Library/Sounds/
The server communicates over stdio transport

🔧 Technical Details

🔌 Transport: Standard I/O (stdio)
📡 Protocol: Model Context Protocol (MCP)
🎧 Audio Backend: macOS afplay command
🎵 Sound Files: System .aiff files

🚨 Error Handling

The server includes comprehensive error handling:

Validates tool names
Handles afplay command failures
Returns appropriate error messages to clients
Graceful server shutdown on errors

📄 License

MIT License

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

🎼 System Sounds Used

🔔 Info: Glass.aiff - A pleasant chime sound
⚠️ Warning: Purr.aiff - A gentle alert sound
❌ Error: Sosumi.aiff - A distinctive error sound

These sounds are built into macOS and provide familiar audio feedback to users.

You must be authenticated.

security – no known vulnerabilities

license - not found

quality - confirmed to work

Tools

A Model Context Protocol server for macOS that enables AI assistants to play system sounds for audio feedback, offering informational, warning, and error sound options.

Related MCP Servers

AivisSpeech MCP Server
kentaro
-
security
F
license
-
quality
A Model Context Protocol server that enables AI assistants to utilize AivisSpeech Engine's high-quality voice synthesis capabilities through a standardized API interface.
Last updated -
TypeScript
MCP Sound Tool
tijs
-
security
A
license
-
quality
A Model Context Protocol implementation that plays sound effects (completion, error, notification) for Cursor AI and other MCP-compatible environments, providing audio feedback for a more interactive coding experience.
Last updated -
Python
MIT License
MCP Apple Reminders
shadowfax92
-
security
F
license
-
quality
A Model Context Protocol server that enables AI assistants to interact with Apple Reminders on macOS, allowing users to view lists, retrieve, create, complete, and delete reminders through natural language.
Last updated -
TypeScript
VOICEVOX MCP Server
Yuki10Kobayashi
A
security
A
license
A
quality
A Model Context Protocol server that integrates with VOICEVOX engine to provide text-to-speech synthesis and speaker information retrieval, allowing users to generate and play voice audio from text.
Last updated -
2
1
TypeScript
MIT License

View all related MCP servers