mcp -notifier

The MCP Server Notifier is a lightweight service that forwards AI task completion events to configured webhooks. It supports multiple webhook providers (Discord, Slack, Microsoft Teams, Feishu, Ntfy, and generic JSON) and can attach images via Imgur. You can embed notifications into Cursor workflows by registering the notifier as an MCP server and invoking the notify tool whenever a task finishes. This makes it easy to centralize alerts across projects and teams. The notifier exposes a simple notify tool that accepts a message, optional title, link, and image parameters, enabling rich, actionable alerts.

To use it, configure the notifier with your webhook URL and type via environment variables, for example WEBHOOK_URL and WEBHOOK_TYPE. You can also supply a webhook-config.json for more advanced setups, including Imgur client IDs and default per-provider settings. For NTfy, you can leverage templates like status, progress, question, and problem to structure messages. The integration with Cursor lets you add notifier as a persistent MCP server, so agents can automatically send notifications when tasks complete without extra prompts.

Prerequisites:

• Node.js and npm installed on your system (or Docker if you prefer containerized usage)
• Access to a shell/terminal

Option A: Install globally via npm

1. Prerequisites: ensure npm is installed
2. Run:

npm install -g mcp-server-notifier

Option B: Run via Docker

1. Prerequisites: Docker installed and running
2. Pull and run the image with environment variables:

docker pull zudsniper/mcp-server-notifier:latest

# Run with required environment variables
docker run -e WEBHOOK_URL=https://your-webhook-url -e WEBHOOK_TYPE=discord zudsniper/mcp-server-notifier

Option C: Build from source

1. Prerequisites: git, Node.js, npm
2. Clone the repository and install dependencies:

git clone https://github.com/zudsniper/mcp-server-notifier.git
cd mcp-server-notifier
npm install
npm run build

3. Run the built server (example):

node build/index.js

• The WEBHOOK_TOKEN environment variable is optional and only affects ntfy webhooks by adding a Bearer token to the Authorization header. It is ignored by all other providers.
• Basic authentication is not supported by this notifier.
• You can enable advanced configuration via webhook-config.json for per-provider settings and an Imgur client ID.
• When using Cursor, you can add the notifier as a global MCP server with the provided command and arguments to streamline usage.
• If you encounter issues, check the MCP Inspector (if installed) to view request/response logs and verify that WEBHOOK_URL and WEBHOOK_TYPE are correctly set.