apple-notes-mcp

🚀 苹果笔记模型上下文协议服务器（Claude Desktop）

本服务器可读取您本地的苹果笔记数据库，并将其提供给Claude Desktop。借助它，Claude能够搜索您那些容易遗忘的笔记，更深入地了解您的信息。

🚀 快速开始

安装服务器

建议使用uv在本地安装该服务器，供Claude使用。

uvx apple-notes-mcp

或者

uv pip install apple-notes-mcp

按照下文所述添加配置。

Claude Desktop

• MacOS：~/Library/Application\ Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%/Claude/claude_desktop_config.json%

注意：您可能需要使用直接的uv路径。请运行which uv找到路径。

开发/未发布的服务器配置

"mcpServers": {
  "apple-notes-mcp": {
    "command": "uv",
    "args": [
      "--directory",
      "{project_dir}",
      "run",
      "apple-notes-mcp"
    ]
  }
}

已发布服务器的配置

"mcpServers": {
  "apple-notes-mcp": {
    "command": "uvx",
    "args": [
      "apple-notes-mcp"
    ]
  }
}

Mac OS磁盘权限

您需要授予该服务器完整的磁盘访问权限。这是因为苹果笔记的SQLite数据库位于MacOS文件系统深处。

如果这给您带来困扰，或者您想开始添加或编辑苹果笔记，您可以考虑使用AppleScript解决方案。

✨ 主要特性

组件

资源

该服务器具备读取和写入苹果笔记的能力。

工具

服务器提供了多个提示：

• get-all-notes：获取所有笔记。
• read-note：获取特定笔记的完整内容。
• search-notes：在笔记中搜索。

📦 安装指南

安装服务器

建议使用uv在本地安装该服务器，供Claude使用。

uvx apple-notes-mcp

或者

uv pip install apple-notes-mcp

按照下文所述添加配置。

Claude Desktop

• MacOS：~/Library/Application\ Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%/Claude/claude_desktop_config.json%

注意：您可能需要使用直接的uv路径。请运行which uv找到路径。

开发/未发布的服务器配置

"mcpServers": {
  "apple-notes-mcp": {
    "command": "uv",
    "args": [
      "--directory",
      "{project_dir}",
      "run",
      "apple-notes-mcp"
    ]
  }
}

已发布服务器的配置

"mcpServers": {
  "apple-notes-mcp": {
    "command": "uvx",
    "args": [
      "apple-notes-mcp"
    ]
  }
}

📚 详细文档

缺失的功能

• 未处理加密笔记（ZISPASSWORDPROTECTED）
• 不支持固定笔记过滤
• 未处理云同步状态
• 缺少附件内容检索
• 不支持检查列表状态（ZHASCHECKLIST）
• 无法创建或编辑笔记

开发

构建和发布

为了准备分发：

1. 同步依赖项并更新锁定文件：

uv sync

2. 构建发行版：

uv build

这将在dist/目录中创建源代码和轮式发行版。 3. 发布到PyPI：

uv publish

注意：您需要通过环境变量或命令行标志设置PyPI凭证：

• 令牌：--token 或 UV_PUBLISH_TOKEN
• 或者用户名/密码：--username/UV_PUBLISH_USERNAME 和 --password/UV_PUBLISH_PASSWORD

调试

由于MCP服务器通过stdio运行，调试可能具有挑战性。为了获得最佳的调试体验，我们强烈推荐使用MCP Inspector。

您可以通过以下命令启动MCP Inspector：

npx @modelcontextprotocol/inspector uv --directory {project_dir} run apple-notes-mcp

启动后，Inspector会显示一个URL，您可以在浏览器中访问以开始调试。

📄 许可证

此项目根据MIT许可证发布。有关详细信息，请参阅LICENSE文件。

🔗 其他信息

源代码

源代码可在GitHub上获得。

为该项目做贡献

将您的想法和反馈发送到我的Bluesky，或通过打开问题来提交。