sound-effects-mcp

# Sound Effects MCP 🎵 This is an MCP server that plays sound effects according to various situations. ## Features - 🎵 3 types of sound effects (Completion, Newtype sound, Error sound) - 🚀 Integration with Claude Desktop - 🛠️ Simple MCP tool - 🎯 Balancing work efficiency and entertainment ## Usage ### Using via Claude Code Add this MCP at the project level in Claude Code: ```bash claude mcp add sound-effects-mcp -s project -- npx -y sound-effects-mcp ``` > [!WARNING] > In some environments, `npx` may not be found. In that case, please check the full path using `which npx` and use it: > > ```bash > # Check the full path of npx > which npx > > # Use the full path (example) > claude mcp add sound-effects-mcp -s project -- /usr/local/bin/npx -y sound-effects-mcp > ``` ### Integration with Claude Desktop Add the following to the Claude Desktop configuration file (`~/Library/Application Support/Claude/claude_desktop_config.json`): ```json { "mcpServers": { "sound-effects-mcp": { "command": "npx", "args": ["-y", "sound-effects-mcp"] } } } ``` ### Available Tools #### `play-sound-effect` Plays various sound effects. **Parameters:** - `sound` (required): Type of sound effect - `complete`: Completion sound (melody) - `newtype`: Newtype sound (kyupeen) - `error`: Error sound (warning sound) - `message` (optional): Message **Usage Example:** ``` Use play-sound-effect to notify task completion with the complete sound ``` #### `list-sound-effects` Displays a list of available sound effects. **Usage Example:** ``` Show me the list of sound effects with list-sound-effects ``` ## Convenient Prompt Settings By adding the following to the CLAUDE.md file in Claude Code, sound effects will automatically play at the appropriate times: ```markdown # Sound Effects - When a task or project is completed, please play the `complete` sound using `play-sound-effect` - When the cause of a problem is identified, please play the `newtype` sound using `play-sound-effect` - When there is an important insight or idea, please play the `newtype` sound using `play-sound-effect` ``` ## Supported Platforms - **macOS**: Plays audio files (MP3) using the `afplay` command Audio files are automatically downloaded and saved in a temporary directory upon the first execution. ## Use Cases This MCP server can be utilized in the following scenarios: - **Completion Sound**: Project completion, end of long processes, task completion - **Newtype Sound**: Special achievements, moments of inspiration, when the cause of a problem is identified (humorous element) - **Error Sound**: When an error occurs, during warnings, in situations requiring attention It is a tool that enhances work efficiency while providing enjoyment. ## Developer Information For development and contribution details, please refer to [CONTRIBUTING.md](./CONTRIBUTING.md). ## License MIT License