🚀 蘋果筆記 MCP 服務器

蘋果筆記 MCP 服務器是一個模型上下文協議（Model Context Protocol）服務器，它支持通過自然語言與 Apple Notes 進行無縫交互。藉助該服務器，你可以使用 Claude 或其他 AI 助手快速創建、搜索和檢索筆記，極大提升工作效率！🎉

🚀 快速開始

先決條件

• 已配置 Apple Notes 應用的 macOS 系統。
• Node.js（版本 20.0.0 或更高）。
• Yarn 包管理器。

安裝

1. 克隆倉庫：

git clone https://github.com/Siddhant-K-code/mcp-apple-notes.git
cd mcp-apple-notes

2. 安裝依賴項：

yarn install

3. 構建項目：

yarn build

4. 啟動服務器：

yarn start

5. 配置 Claude Desktop。更新你的 claude_desktop_config.json 文件，添加：

{
  "mcpServers": {
    "apple-notes": {
      "command": "yarn",
      "args": ["start"],
      "cwd": "/path/to/mcp-apple-notes"
    }
  }
}

⚠️ 重要提示

將 /path/to/mcp-apple-notes 替換為你實際的克隆倉庫路徑。首次運行命令時，可能需要授權腳本訪問 Apple Notes。

MCP 服務器初始化

當服務器成功啟動後，你會看到：

正在啟動蘋果筆記 MCP 服務器。

此時，服務器已準備好處理你的筆記操作！🎉

✨ 主要特性

• 創建筆記：可快速生成新筆記，支持設置標題、內容和標籤 📝。
• 搜索筆記：藉助強大的搜索功能查找筆記 🔍。
• 檢索內容：能根據標題獲取任意筆記的完整內容 📖。
• iCloud 集成：可直接與你的 iCloud 筆記賬戶連接 ☁️。

📦 安裝指南

安裝步驟如下：

1. 克隆倉庫：

git clone https://github.com/Siddhant-K-code/mcp-apple-notes.git
cd mcp-apple-notes

2. 安裝依賴項：

yarn install

3. 構建項目：

yarn build

4. 啟動服務器：

yarn start

5. 配置 Claude Desktop。更新 claude_desktop_config.json 文件：

{
  "mcpServers": {
    "apple-notes": {
      "command": "yarn",
      "args": ["start"],
      "cwd": "/path/to/mcp-apple-notes"
    }
  }
}

💻 使用示例

基礎用法

快速創建筆記

# 創建新筆記
create-note --title "每日計劃" --content "今天的工作安排如下：..."

信息檢索

# 搜索筆記
search-notes --query "會議記錄"

# 根據標題獲取內容
retrieve-content --title "項目總結"

高級用法

本部分可參考前文“🛠️ 使用方法”中各工具的詳細參數說明，根據實際需求靈活組合參數，實現更復雜的筆記操作。

📚 詳細文檔

可用工具

創建筆記

• 描述：在 Apple Notes 中創建新筆記。
• 參數：

{
  title: string;      // 筆記標題
  content: string;    // 筆記內容
  tags?: string[];   // 可選，筆記標籤
}

• 示例響應：正在為您的新筆記生成內容...

搜索筆記

• 描述：通過關鍵詞或短語查找筆記。
• 參數：

{
  query: string;
}

• 示例響應：返回匹配的筆記列表。

檢索內容

• 描述：根據標題獲取筆記內容。
• 參數：

{
  title: string;
}

• 示例響應：返回指定標題的筆記內容。

🔧 技術細節

本項目使用 TypeScript 和 Node.js 構建，集成 AppleScript 進行底層操作。代碼倉庫託管於 GitHub，並提供詳細的文檔支持。

📄 許可證

項目遵循 MIT 許可證，具體內容請參考 LICENSE 文件。

結語

歡迎使用蘋果筆記 MCP 服務器，通過自然語言與你的筆記數據無縫交互，提升工作效率！