toast-mcp-server

by naru-sensei

Utilities Server Notifications Windows macOS Python

This project creates an MCP server that displays desktop notifications on Windows 10 and macOS. It receives requests from MCP clients and displays notifications accordingly.

View on GitHub

Last updated: N/A

What is toast-mcp-server?

This is a Model Context Protocol (MCP) server that enables desktop notifications on Windows 10 and macOS. It uses win10toast library for Windows and osascript for macOS to display notifications based on requests from MCP clients.

How to use toast-mcp-server?

Ensure you have Python 3.8 or higher installed.
Install the necessary dependencies (e.g., win10toast for Windows).
Run the server using the command: python mcp_server.py --port 8000 --host 0.0.0.0 (adjust port and host as needed).
Use an MCP client (like VSCode Cline) to send notification commands to the server.

Key features of toast-mcp-server

Supports MCP protocol for communication with clients
Displays desktop notifications on Windows 10 and macOS
Configurable network interface and port
Handles multiple concurrent client connections
Supports customizable notification parameters (title, message, icon, etc.)

Use cases of toast-mcp-server

Displaying build status notifications from a CI/CD pipeline
Alerting users of important events or messages from a remote system
Providing real-time feedback from a background process
Integrating desktop notifications into VSCode Cline or other MCP-compatible applications

FAQ from toast-mcp-server

What is MCP?

Model Context Protocol is a communication protocol used by some applications to exchange information.

What platforms are supported?

Windows 10 and macOS are supported.

What is the default port?

The default port is 8000.

How do I configure the server?

You can configure the server using command-line arguments or environment variables.

What libraries are required?

win10toast is required for Windows 10 notifications. macOS uses osascript, which is pre-installed.