详细介绍
Apple Notes MCP 是一个专为 Claude Desktop 设计的服务器工具,允许用户通过本地 Apple Notes 数据库进行笔记的读取和搜索。该工具通过 Model Context Protocol(MCP)协议,将 Apple Notes 的内容集成到 Claude Desktop 中,使用户能够更高效地管理和检索笔记。
核心功能
Apple Notes MCP 提供了以下核心功能,帮助用户在 Claude Desktop 中访问和管理 Apple Notes:
- 获取所有笔记:列出所有 Apple Notes 笔记,便于快速浏览。
- 阅读特定笔记:查看单个笔记的完整内容,包括标题和正文。
- 搜索笔记:通过关键词搜索笔记内容,快速定位所需信息。
安装方法
Apple Notes MCP 可通过 uvx 或 uv pip 命令进行安装。以下是安装步骤:
uvx apple-notes-mcpuv pip install apple-notes-mcp安装完成后,需要在 Claude Desktop 的配置文件中添加服务器配置,以便与 Apple Notes MCP 进行集成。
配置说明
在安装 Apple Notes MCP 后,需要在 Claude Desktop 的配置文件中添加服务器地址。以下是两种配置方式:
开发/未发布的服务器配置:
"mcpServers": {
"apple-notes-mcp": {
"command": "uv",
"args": [
"--directory",
"{project_dir}",
"run",
"apple-notes-mcp"
]
}
}
已发布服务器的配置:
"mcpServers": {
"apple-notes-mcp": {
"command": "uvx",
"args": [
"apple-notes-mcp"
]
}
}
配置完成后,Claude Desktop 将能够通过 Apple Notes MCP 读取和搜索本地 Apple Notes 数据库。
使用方法
Apple Notes MCP 提供了多种命令,用于读取和搜索 Apple Notes 数据库。以下是常用命令及其使用方式:
get-all-notes该命令用于获取所有 Apple Notes 笔记的列表。
read-note note_id该命令用于读取指定 ID 的笔记内容。
search-notes query="关键词"该命令用于通过关键词搜索 Apple Notes 笔记。
使用示例
以下是 Apple Notes MCP 的使用示例:
get-all-notes执行该命令后,将返回所有 Apple Notes 笔记的标题和摘要。
search-notes query="旅行计划"执行该命令后,将返回包含“旅行计划”关键词的笔记内容。
注意事项
在使用 Apple Notes MCP 时,需要注意以下事项:
- 权限设置:在 macOS 上,需要授予 Apple Notes MCP 服务器完整的磁盘访问权限,以便访问 Apple Notes 数据库。
- 功能限制:目前不支持加密笔记、附件内容检索、创建或编辑笔记。
- 调试工具:建议使用 MCP Inspector 工具进行调试。
Apple Notes MCP 为用户提供了便捷的 Apple Notes 数据库访问方式,使用户能够在 Claude Desktop 中快速查找和管理笔记内容。