Back to MCP directory
publicPublicdnsLocal runtime

my-apple-remembers

一个通过MCP协议访问苹果设备数据的服务,支持记忆存储与读取

article

README

🚀 MCP 服务器 - 我的苹果记忆

这是一个简单的 MCP 服务器,可用于从 Apple Notes 回忆和保存记忆,方便您随时回顾重要信息。

Docker Pulls License: MIT

🚀 快速开始

您可以通过此 MCP 服务器轻松实现从 Apple Notes 回忆和保存记忆,只需按后续步骤完成安装和配置即可。

✨ 主要特性

  • 记忆回忆:可访问笔记、日历事件、信息、文件和其他来自 Mac 的信息。
  • 记忆持久化:能将重要信息保存到 Apple Notes 中,以便将来参考。
  • 最小化设置:仅需在目标 Mac 上启用远程登录。
  • 通用兼容性:适用于所有 macOS 版本。

📦 安装指南

您可以通过将以下内容添加到您的 Claude 配置中,配置 Claude Desktop 使用 Docker 镜像:

{
  "mcpServers": {
    "my-apple-remembers": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "-e",
        "MACOS_USERNAME=your_macos_username",
        "-e",
        "MACOS_PASSWORD=your_macos_password",
        "-e",
        "MACOS_HOST=localhost",
        "--rm",
        "buryhuang/mcp-my-apple-remembers:latest"
      ]
    }
  }
}

💻 使用示例

基础用法

您可以使用提示来指示如何保存您的记忆。例如:

你应该始终将回忆和保存记忆的文件夹设为 "baryhuang"。

📚 详细文档

开发人员指南

克隆仓库

# 克隆仓库
git clone https://github.com/baryhuang/mcp-my-apple-remembers.git
cd mcp-my-apple-remembers

构建 Docker 镜像

# 构建 Docker 镜像
docker build -t mcp-my-apple-remembers .

发布多平台 Docker 镜像

# 设置 Docker buildx 用于多平台构建
docker buildx create --use

# 构建并推送多平台镜像
docker buildx build --platform linux/amd64,linux/arm64 -t buryhuang/mcp-my-apple-remembers:latest --push .

工具规格说明

  • my_apple_recall_memory:在远程 macOS 系统上运行 AppleScript 命令以回忆记忆。此工具帮助访问 Mac 上的 Apple Notes、日历事件、iMessages、聊天记录、文件和其他信息。
  • my_apple_save_memory:在远程 macOS 系统上运行 AppleScript 命令以保存重要信息。此工具允许 AI 将相关信息持久化到 Apple Notes 中以便将来参考。

所有工具均要求 macOS SSH 访问权限,包括主机和密码。

⚠️ 重要提示

始终使用安全且经过身份验证的连接访问远程 macOS 机器。此工具仅应用于您信任并获得授权访问的服务器。

📄 许可证

有关详细信息,请参阅 LICENSE 文件。

help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client