Apple Reminders

苹果提醒MCP服务器

MCP服务器，通过以下方式提供对Apple提醒的访问 remindctl CLI。

特性

• 列表提醒：查看“活动”、“委派”或“待办事项”列表中的任务。
• 创建提醒：添加带有截止日期和注释的新任务。
• 编辑提醒：修改现有任务。
• 完成/删除：管理任务生命周期。
• 苏格兰和南方能源公司运输：作为具有服务器发送事件的独立HTTP服务器运行。
• 自动启动：通过macOS启动代理登录时自动启动。
• 安全STDIO：将所有日志重定向到 stderr 当使用stdio传输来防止JSON-RPC损坏时。
• 流程管理：将PID写入 server.pid 并在出口处进行清理。

先决条件

• macOS 14+（索诺玛或更高版本）
• Node.js（推荐LTS）
• remindctl （如果缺失，将通过Homebrew安装）

安装

1. 克隆或下载此存储库。
2. 运行安装脚本：

   cd mcp-server-apple-reminders
   ./install.sh

*注意：这也将设置一个macOS启动代理，以便在登录时自动启动服务器。*

用法

启动服务器

要在后台启动服务器，请执行以下操作：

./start.sh

这将把进程ID写入 server.pid 并记录到 server.log / stderr.log.

停止服务器

要停止后台服务器，请执行以下操作：

./stop.sh

配置

复制 .env.example 到 .env 如果需要自定义端口（默认值6371）。

客户端配置

要配置MCP客户端（如Claude Desktop或扩展）通过SSE使用此服务器，请执行以下操作：

服务器URL: http://localhost:6371/sse

如果您的客户端要求单独列出消息端点： 消息端点: http://localhost:6371/messages

连接类型：SSE（服务器发送事件）

示例：Claude桌面配置(claude_desktop_config.json)

目前，Claude Desktop主要支持stdio。要将此服务器与Claude Desktop一起使用，您应该将其配置为直接通过以下方式运行构建的源代码 node:

{
  "mcpServers": {
    "apple-reminders": {
      "command": "node",
      "args": [
        "/absolute/path/to/mcp-server-apple-reminders/dist/index.js",
        "--stdio"
      ]
    }
  }
}

如果您使用的客户端支持远程/HTTP MCP服务器，请使用上面的SSE URL。

工具

许可证

麻省理工学院