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

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

site icon
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)的通信,适用于开发环境中的通知需求。

核心功能

  1. MCP协议支持
  2. 实现MCP协议,支持与客户端的通信。
  3. 支持同步和异步请求处理。

  4. 通知系统

  5. Windows 10使用win10toast库显示通知。
  6. macOS使用osascript显示通知。
  7. 支持自定义通知参数(标题、消息内容、显示时间、图标等)。

  8. 客户端连接

  9. 支持配置网络接口和端口。
  10. 处理多个同时客户端连接。

  11. 命令处理

  12. 处理MCP客户端的通知命令。
  13. 提供简单的API触发通知。

适用场景

  1. 开发环境中需要显示桌面通知的场景。
  2. 与VSCode Cline等MCP客户端集成的场景。
  3. 需要自定义通知参数(如标题、消息内容等)的场景。

工具列表

  1. win10toast:用于Windows 10的桌面通知。
  2. osascript:用于macOS的通知中心显示通知。

常见问题解答

  1. 如何配置服务器监听所有接口?
  2. 使用--host 0.0.0.0参数启动服务器。

  3. 如何自定义通知参数?

  4. 通过MCP客户端发送包含自定义参数的请求。

使用教程

使用依赖

  1. Python 3.8及以上版本
  2. 确保系统已安装Python 3.8或更高版本。

  3. 安装依赖库

  4. 运行以下命令安装依赖: bash pip install win10toast

安装教程

  1. 克隆项目或下载源码
  2. 从项目仓库克隆或下载源码。

  3. 安装依赖

  4. 进入项目目录,运行: bash pip install -r requirements.txt

  5. 启动服务器

  6. 运行以下命令启动服务器: bash python mcp_server.py --port 8000 --host 0.0.0.0

调试方式

  1. 查看日志
  2. 服务器启动后,查看日志文件以确认运行状态。

  3. 测试通知

  4. 使用MCP客户端发送测试通知请求,确认通知功能正常。

  5. 检查端口

  6. 确保端口8000未被其他服务占用。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。