🚀 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）。
• 为处理同时请求采用适当的线程或异步模式。
• 包含适当的输入验证等安全措施。
• 提供详细的日志选项，以便对连接问题进行调试。
• 实现服务器的适当关闭。