-toast-mcp-server
3
This project provides an MCP server to display desktop notifications on Windows 10 and macOS, integrating with MCP clients like VSCode Cline. It supports customizable notifications and asynchronous server operations with minimal dependencies.
Overview
This project aims to create a Model Context Protocol (MCP) server capable of displaying desktop notifications on Windows 10 and macOS. It uses the win10toast library for Windows notifications and osascript for macOS notifications. The server receives requests from MCP clients, such as VSCode Cline, to display notifications.
Features
- MCP Protocol Support: Implementation of the Model Context Protocol for communication with MCP clients, supporting synchronous and asynchronous requests.
- Notification System: Customizable notifications using win10toast for Windows and osascript for macOS with support for various parameters like title, message, display time, and notification type.
- Client Connection: Supports listening on configurable network interfaces and ports, handling multiple simultaneous client connections with error handling.
- Command Processing: Processes notification commands from MCP clients with a simple API, providing command validation and appropriate error responses.
- Technical Requirements: Implemented using Python 3.8+ with asyncio for asynchronous server tasks. Minimal external dependencies.
Deliverables
- MCP server implemented in Python.
- Test scripts demonstrating functionality.
- Documentation for usage and configuration.