MCP Notifications

This project is a spiritual successor to the original mcp-server-notifier by tuberrabbit@gmail.com, and has been significantly rewritten and is now maintained by zudsniper.

A modern, scalable notification service that integrates with MCP (Model Context Protocol) to send real-time notifications and webhooks when AI agents complete tasks. Now featuring a monorepo architecture with SSE (Server-Sent Events) support, Next.js web interface, and PocketBase integration.

简体中文文档

🚀 What's New in v3.0

• Monorepo Architecture: Organized as a workspace with separate apps and packages
• SSE Server: Real-time notifications via Server-Sent Events (Cloudflare Worker with Durable Objects)
• Web Dashboard: Next.js-based interface for monitoring and managing notifications
• PocketBase Integration: Persistent storage for webhooks, connections, and notification history
• Enhanced Provider Support: Improved webhook formatting for all major platforms
• Rate Limiting: Built-in rate limiting with KV storage
• Connection Management: Automatic cleanup and heartbeat for SSE connections
• TypeScript Throughout: Full TypeScript support with shared types package

Features

• Real-time Notifications: SSE-based push notifications for instant updates
• Webhook Notifications: Receive alerts when your AI agents complete tasks
• Multiple Webhook Providers: Support for Discord, Slack, Microsoft Teams, Feishu, Ntfy, and custom webhooks
• Image Support: Include images in notifications via Imgur
• Multi-Project Support: Efficiently manage notifications across different projects
• Easy Integration: Simple setup with AI tools like Cursor
• Customizable Messages: Send personalized notifications with title, body, and links
• Discord Embed Support: Send rich, customizable Discord embed notifications
• NTFY Template Support: Use pre-defined templates for status, questions, progress, and problems
• Notification History: Track all notifications with PocketBase storage
• Fallback Support: Configure backup webhooks for critical notifications
• Queue Processing: Reliable webhook delivery with queue-based processing

Architecture

The v3.0 architecture consists of multiple components working together:

1. SSE Server (Cloudflare Worker): Manages real-time connections using Durable Objects
2. Web Dashboard (Next.js): User interface for monitoring and configuration
3. PocketBase: Persistent storage for webhooks, templates, and history
4. Queue System: Reliable webhook delivery with retry logic
5. Legacy MCP Server: Backward compatibility for existing integrations

Data Flow

User/AI Agent → SSE Server → Queue → Webhook Provider
                    ↓           ↓
              PocketBase   Rate Limiter
                    ↓
              Web Dashboard

Project Structure

This is a monorepo organized with npm workspaces:

mcp-notifications/
├── apps/
│   ├── sse-server/      # Cloudflare Worker for SSE connections
│   └── web/             # Next.js dashboard
├── packages/
│   └── shared/          # Shared types and utilities
├── legacy/              # Legacy MCP server implementation
└── pocketbase/          # PocketBase schema and migrations

Installation

For Development

# Clone the repository
git clone https://github.com/zudsniper/mcp-notifications.git
cd mcp-notifications

# Install dependencies for all workspaces
npm install

# Build all packages
npm run build

Deploy SSE Server (Cloudflare Worker)

cd apps/sse-server
npm run deploy

Run Web Dashboard

cd apps/web
npm run dev

Legacy MCP Server

The original MCP server is still available in the legacy/ directory:

cd legacy
npm install
npm run build

Integration

S

... View full README on GitHub