Toast MCP Server

🚀 Windows 10 和 macOS 帶有通知功能的 MCP 服務器

本項目致力於打造一個具備桌面通知顯示功能的 Model Context Protocol (MCP) 服務器。在 Windows 10 系統中藉助 win10toast 庫，而在 macOS 系統則利用 osascript 來實現通知展示。該服務器能夠接收來自 MCP 客戶端（例如 VSCode Cline）的請求，並依據這些請求在桌面呈現相應通知。

🚀 快速開始

完成後的服務器可以按照以下命令運行：

python mcp_server.py --port 8000 --host 0.0.0.0

之後，可通過 VSCode Cline 或其他 MCP 客戶端，藉助 MCP 協議觸發通知。

✨ 主要特性

功能特性

• MCP 協議支持：實現與 MCP 客戶端的通信，構建 Model Context Protocol，支持最新的 MCP 規格，確保與 VSCode Cline 完全兼容，同時能夠處理同步和異步請求。
• 通知系統：在 Windows 10 上運用 win10toast 庫顯示桌面通知，在 macOS 上通過 osascript 在 NotificationCenter 中顯示通知。支持可自定義的通知參數，涵蓋標題、消息內容、顯示時間、圖標（Windows 專用，可選）、副標題（macOS 專用，可選）、通知音（macOS 專用，可選）以及通知類型（信息、警告、錯誤、成功）。
• 客戶端連接：支持在設置的網絡接口上進行偵聽，不僅侷限於 localhost 的 127.0.0.1，還支持所有接口的 0.0.0.0。支持設置端口（默認：8000），能夠處理多個同時的客戶端連接，並對連接問題進行適當的錯誤處理。
• 命令處理：處理來自 MCP 客戶端的通知命令，支持觸發通知的簡單 API，進行命令驗證並提供適當的錯誤響應。

技術特性

• 服務器實現：採用 Python 3.8 或更高版本進行開發，使用 asyncio 或類似庫實現異步服務器，遵循 MCP 服務器實現的最佳實踐。
• 依賴關係：依賴 Windows 10 桌面通知用的 win10toast、macOS 通知用的 osascript（系統自帶）以及實現 MCP 協議所需的庫，同時儘量減少外部依賴項。
• 配置：支持通過命令行參數和環境變量進行設置，併為所有設置提供合理的默認值。
• 日誌記錄和錯誤處理：實現全面的日誌系統，記錄所有客戶端連接、命令和錯誤，進行有意義的錯誤消息的適當異常處理。

測試特性

• 測試腳本：包含用於驗證服務器功能的測試腳本，展示各種通知類型的示例。
• 客戶端互操作性：確保與 VSCode Cline 的互操作性，並文檔化客戶端特有的設置要求。

📦 安裝指南

本項目依賴的庫可通過 requirements.txt 文件進行安裝，執行以下命令：

pip install -r requirements.txt

💻 使用示例

基礎用法

完成後的服務器可以這樣運行：

python mcp_server.py --port 8000 --host 0.0.0.0

之後，可通過 VSCode Cline 或其他 MCP 客戶端，藉助 MCP 協議觸發通知。

📚 詳細文檔

成果物

• Python 實現的 MCP 服務器。
• 用於驗證功能的測試腳本。
• 列出所有依賴項的 requirements.txt 文件。
• 關於使用方法和配置的相關文檔。
• 針對一般問題的故障排除指南。

實現注意事項

• 讓服務器綁定到 localhost 之外的所有接口（0.0.0.0）。
• 為處理同時請求採用適當的線程或異步模式。
• 包含適當的輸入驗證等安全措施。
• 提供詳細的日誌選項，以便對連接問題進行調試。
• 實現服務器的適當關閉。