
Windows 10 および macOS 通知機能付き MCP サーバー

2025.04.06
2
Python通知服务开发工具开发效率
该项目是一个支持Windows 10和macOS桌面通知的Model Context Protocol (MCP)服务器。它通过MCP协议与客户端(如VSCode Cline)通信,接收请求并显示桌面通知。服务器支持多种通知参数的自定义,包括标题、消息内容、显示时间、图标等,并提供了灵活的配置选项和详细的日志记录功能。
View on GitHub
Overview
基本能力
产品定位
该MCP服务器主要用于在Windows 10和macOS系统上显示桌面通知,支持与MCP客户端(如VSCode Cline)的通信,适用于开发环境中的通知需求。
核心功能
- MCP协议支持
- 实现MCP协议,支持与客户端的通信。
-
支持同步和异步请求处理。
-
通知系统
- Windows 10使用win10toast库显示通知。
- macOS使用osascript显示通知。
-
支持自定义通知参数(标题、消息内容、显示时间、图标等)。
-
客户端连接
- 支持配置网络接口和端口。
-
处理多个同时客户端连接。
-
命令处理
- 处理MCP客户端的通知命令。
- 提供简单的API触发通知。
适用场景
- 开发环境中需要显示桌面通知的场景。
- 与VSCode Cline等MCP客户端集成的场景。
- 需要自定义通知参数(如标题、消息内容等)的场景。
工具列表
- win10toast:用于Windows 10的桌面通知。
- osascript:用于macOS的通知中心显示通知。
常见问题解答
- 如何配置服务器监听所有接口?
-
使用
--host 0.0.0.0
参数启动服务器。 -
如何自定义通知参数?
- 通过MCP客户端发送包含自定义参数的请求。
使用教程
使用依赖
- Python 3.8及以上版本
-
确保系统已安装Python 3.8或更高版本。
-
安装依赖库
- 运行以下命令安装依赖:
bash pip install win10toast
安装教程
- 克隆项目或下载源码
-
从项目仓库克隆或下载源码。
-
安装依赖
-
进入项目目录,运行:
bash pip install -r requirements.txt
-
启动服务器
- 运行以下命令启动服务器:
bash python mcp_server.py --port 8000 --host 0.0.0.0
调试方式
- 查看日志
-
服务器启动后,查看日志文件以确认运行状态。
-
测试通知
-
使用MCP客户端发送测试通知请求,确认通知功能正常。
-
检查端口
- 确保端口8000未被其他服务占用。