Apple Notes MCP Server 使用说明

项目简介

Apple Notes MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器，它允许 Claude Desktop 等 LLM 应用访问和利用您本地的 Apple Notes 数据。通过此服务器，您可以让 LLM 理解您的笔记内容，从而实现更深入的对话和知识检索。

主要功能点

资源 (Resources): 将 Apple Notes 数据库中的笔记作为资源进行管理和访问。
工具 (Tools): 提供以下工具供 LLM 调用：
- 'get-all-notes': 获取所有笔记的列表。
- 'read-note': 读取指定笔记的完整内容。
- 'search-notes': 在笔记中搜索关键词。
Prompt 模板 (Prompts): 提供 'find-note' Prompt，用于根据用户查询查找相关笔记。

安装步骤

确保已安装 uv (推荐) 或 'pip'。

使用以下命令安装服务器：

uvx apple-notes-mcp

或者

uv pip install apple-notes-mcp

服务器配置

打开 Claude Desktop 的配置文件 'claude_desktop_config.json'。
- MacOS: '~/Library/Application\ Support/Claude/claude_desktop_config.json'
- Windows: '%APPDATA%/Claude/claude_desktop_config.json'

在 'mcpServers' 中添加 'apple-notes-mcp' 服务器配置。

开发/未发布服务器配置

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

'command': 运行服务器的命令，这里使用 'uv'。
'args': 命令参数，'--directory {project_dir} run apple-notes-mcp' 指定了项目目录和运行 'apple-notes-mcp'。

已发布服务器配置

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

'command': 运行已发布服务器的命令，这里使用 'uvx'。
'args': 命令参数，'apple-notes-mcp' 指定了要运行的服务器名称。

基本使用方法

安装并配置服务器后，在 Claude Desktop 中启用 'apple-notes-mcp' 服务器。
Claude 将能够使用您配置的服务器来访问和搜索您的 Apple Notes。您可以指示 Claude 使用 'get-all-notes', 'read-note', 或 'search-notes' 工具，或者使用 'find-note' prompt 来与您的笔记进行交互。

注意: 首次使用可能需要授予服务器 "完全磁盘访问权限" 以读取 Apple Notes 数据库。

关键词