MCP.so
登录

Notifications MCP Server

@pinkpixel-dev

基本信息

分类

沟通协作

传输方式

stdio

作者

pinkpixel-dev

关于 Notifications MCP Server

A Model Context Protocol server that allows AI agents to play a notification sound via a tool when a task is completed.

Notifications MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "notification-mcp": {
      "command": "npx",
      "args": [
        "@pinkpixel/notification-mcp"
      ]
    }
  }
}

Notifications MCP Server 工具

2

Play a notification sound to indicate task completion

Show a toast notification and/or play a sound when tasks complete

概览

What is ✨ Notifications MCP Server ✨?

A Model Context Protocol server that allows AI agents to play notification sounds when tasks are completed. It is TypeScript-based and comes with bundled sounds that work out of the box with npx.

How to use ✨ Notifications MCP Server ✨?

Configure it in your MCP client with command: "npx" and args: ["-y", "@pinkpixel/notification-mcp"]. Optionally set environment variables MCP_NOTIFICATION_SOUND (chooses from 5 bundled sounds) or MCP_NOTIFICATION_SOUND_PATH (custom MP3 file). Then call the play_notification tool with an optional message parameter.

Key features of ✨ Notifications MCP Server ✨

  • Plays notification sounds when tasks are completed.
  • Cross-platform support (Windows and macOS).
  • Offers 5 high-quality bundled sounds: cosmic, fairy, gentle, pleasant, retro.
  • Supports random sound selection with MCP_NOTIFICATION_SOUND=random.
  • Allows custom MP3 files via MCP_NOTIFICATION_SOUND_PATH.
  • Works immediately via npx without manual downloads.

Use cases of ✨ Notifications MCP Server ✨

  • Playing a sound after an AI agent finishes a long task.
  • Providing audio feedback for completed operations in MCP-based workflows.
  • Customizing notification tones for different types of task completions.
  • Using a random sound each time for variety in notifications.

常见问题

1

What sounds are included?

Five bundled sounds: cosmic (space-themed), fairy (magical), gentle (soft default), pleasant (professional), and retro (vintage). You can also set `MCP_NOTIFICATION_SOUND=random` to play one at random.

2

How do I use my own sound file?

Set the environment variable `MCP_NOTIFICATION_SOUND_PATH` to the absolute path of your MP3 file. This overrides the bundled sounds.

3

How do I install and run the server?

No installation is required; just run `npx @pinkpixel/notification-mcp`. You can also install globally with `npm install -g @pinkpixel/notification-mcp` and run `notification-mcp`.

4

What are the system requirements?

The server requires Node.js and works on Windows and macOS. Sound playback uses platform-native capabilities.

5

Can I change the default sound?

Yes. Set `MCP_NOTIFICATION_SOUND` to one of `cosmic`, `fairy`, `gentle`, `pleasant`, `retro`, or `random`. The default is `gentle`.

评论

沟通协作 分类下的更多 MCP 服务器