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

项目概述

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

需求

功能需求

1. MCP 协议支持

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

2. 通知系统

   • 在 Windows 10 上使用 win10toast 库显示桌面通知
   • 在 macOS 上使用 osascript 在NotificationCenter中显示通知
   • 支持可自定义的通知参数：
     • 标题
     • 消息内容
     • 显示时间
     • 图标（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. Python 实现的 MCP 服务器
2. 验证功能的测试脚本
3. 列出所有依赖项的 requirements.txt
4. 使用方法和配置的相关文档
5. 一般问题的故障排除指南

实现注意事项

• 让服务器绑定到 localhost 之外的所有接口（0.0.0.0）
• 为处理同时请求使用适当的线程或异步模式
• 包含适当的输入验证等安全措施
• 提供详细的日志选项以便连接问题的调试
• 实现服务器的适当关闭

使用示例

完成后的服务器可以这样运行：

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

然后，可以通过 VSCode Cline 或其他 MCP 客户端通过 MCP 协议触发通知。