带有 Windows 10 和 macOS 通知功能的 MCP 服务器

项目概述

本项目旨在创建一个能够显示桌面通知的 Model Context Protocol (MCP) 服务器。在 Windows 10 上，它将使用 win10toast 库来显示通知，而在 macOS 上，它将使用 osascript。该服务器将接收来自 MCP 客户端（例如 VSCode Cline）的请求，并据此显示桌面通知。

要求

功能性要求

1. MCP 协议支持

   • 实现 Model Context Protocol 以建立与 MCP 客户端的通信。
   • 支持最新的 MCP 规范（提供与 VSCode Cline 的完全兼容性）。
   • 处理同步和异步请求。

2. 通知系统

   • 在 Windows 10 上使用 win10toast 库显示桌面通知。
   • 在 macOS 上使用 osascript 将通知显示在通知中心。
   • 支持可定制的通知参数：
     • 标题
     • 消息内容
     • 显示时间
     • 图标（仅限 Windows，可选）
     • 副标题（仅限 macOS，可选）
     • 通知声音（仅限 macOS，可选）
     • 通知类型（信息、警告、错误、成功）

3. 客户端连接

   • 在可配置的网络接口上监听（不仅是 localhost 的 127.0.0.1，还包括支持所有接口的 0.0.0.0）。
   • 可配置的端口（默认：8000）。
   • 处理多个并发客户端连接。
   • 针对连接问题提供适当的错误处理。

4. 命令处理

   • 处理来自 MCP 客户端的通知命令。
   • 支持用于触发通知的简单 API。
   • 提供命令验证和适当的错误响应。

技术要求

1. 服务器实现

   • 实现应使用 Python 3.8 或更高版本。
   • 实现为使用 asyncio 或类似库的异步服务器。
   • 遵循 MCP 服务器实现的最佳实践。

2. 依赖关系

   • 用于 Windows 10 桌面通知的 win10toast。
   • 用于 macOS 通知的 osascript（系统自带）。
   • MCP 协议实现所需的库。
   • 尽量减少外部依赖。

3. 配置

   • 支持通过命令行参数进行配置。
   • 支持通过环境变量进行配置。
   • 为所有配置提供合理的默认值。

4. 日志记录和错误处理

   • 实现全面的日志系统。
   • 记录所有客户端连接、命令和错误。
   • 包含有意义的错误消息的适当异常处理。

测试要求

1. 测试脚本

   • 包含演示服务器功能的测试脚本。
   • 演示各种通知类型。

2. 客户端兼容性

   • 确保与 VSCode Cline 的兼容性。
   • 记录客户端特定的配置要求。

成果物

1. MCP 服务器的 Python 实现。
2. 演示功能的测试脚本。
3. 列出所有依赖项的 requirements.txt。
4. 关于使用方法和配置的文档。
5. 常见问题故障排除指南。

实现上的注意

• 确保服务器绑定到所有接口（0.0.0.0），而不仅仅是 localhost。
• 使用适当的线程或异步模式来处理并发请求。
• 包含适当的安全措施（例如输入验证）。
• 提供详细的日志选项，以便调试连接问题。
• 实现服务器的适当关闭。

使用示例

完成的服务器应能够像这样运行：

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

然后，应该能够通过 VSCode Cline 或其他 MCP 客户端通过 MCP 协议触发通知。