-toast-mcp-server
If you are the rightful owner of -toast-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
This project aims to create a Model Context Protocol (MCP) server capable of displaying desktop notifications on Windows 10 and macOS.
The MCP server is designed to handle requests from MCP clients, such as VSCode Cline, to display desktop notifications. On Windows 10, it utilizes the win10toast library, while on macOS, it employs osascript for notification display. The server supports both synchronous and asynchronous requests, ensuring compatibility with the latest MCP specifications. It allows for customizable notification parameters, including title, message content, display duration, and more. The server is implemented in Python 3.8 or higher, using asyncio for asynchronous operations, and follows best practices for MCP server implementation. It supports configurable network interfaces and ports, handles multiple simultaneous client connections, and includes comprehensive logging and error handling.
Features
- MCP Protocol Support: Implements Model Context Protocol for communication with MCP clients, supporting the latest MCP specifications and handling both synchronous and asynchronous requests.
- Notification System: Displays desktop notifications using win10toast on Windows 10 and osascript on macOS, with support for customizable parameters like title, message, and display time.
- Client Connection: Listens on configurable network interfaces and ports, handles multiple simultaneous client connections, and provides robust error handling.
- Command Processing: Processes notification commands from MCP clients, supports a simple API for triggering notifications, and provides command validation with error responses.
- Server Implementation: Implemented in Python 3.8+, using asyncio for asynchronous operations, with minimal external dependencies and comprehensive logging.