Apple Voice Memo MCP

🚀 Apple Voice Memo MCP 服務器

這是一個 MCP（模型上下文協議）服務器，可讓你以編程方式訪問 macOS 上的 Apple 語音備忘錄。藉助它，Claude 等 AI 助手就能與你的語音錄音進行交互。

它與 whisper-mcp 配合使用，可實現本地轉錄。

🚀 快速開始

本服務器可讓你通過編程方式訪問 macOS 上的 Apple 語音備忘錄，還能讓 AI 助手與語音錄音交互。

✨ 主要特性

• 列出語音備忘錄 - 瀏覽所有語音備忘錄及其元數據。
• 獲取備忘錄詳情 - 獲取特定錄音的詳細信息。
• 獲取音頻 - 訪問音頻文件路徑或 Base64 編碼的音頻數據。
• 獲取轉錄內容 - 從備忘錄中提取轉錄內容（Apple 存儲在音頻文件中）。
• 轉錄備忘錄 - 使用 Apple 的 SFSpeechRecognizer 生成轉錄內容。

📦 安裝指南

npm install -g apple-voice-memo-mcp

或者直接使用 npx：

npx apple-voice-memo-mcp

📚 詳細文檔

配置

Claude Desktop

添加到你的 Claude Desktop 配置文件中： macOS：~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "apple-voice-memo-mcp": {
      "command": "npx",
      "args": ["-y", "apple-voice-memo-mcp"]
    }
  }
}

編輯完成後，重啟 Claude Desktop。

Claude Code (CLI)

對於 Claude Code，添加到項目的 .mcp.json 文件中：

{
  "mcpServers": {
    "apple-voice-memo-mcp": {
      "command": "npx",
      "args": ["-y", "apple-voice-memo-mcp"]
    }
  }
}

或者進行用戶範圍的配置，添加到 ~/.claude/settings.json 中：

{
  "mcpServers": {
    "apple-voice-memo-mcp": {
      "command": "npx",
      "args": ["-y", "apple-voice-memo-mcp"]
    }
  }
}

提示：在 Claude Code 中使用 /mcp 來驗證服務器是否已連接。

本地開發設置

如果從源代碼而不是 npm 運行：

{
  "mcpServers": {
    "apple-voice-memo-mcp": {
      "command": "node",
      "args": ["/path/to/apple-voice-memo-mcp/dist/index.js"]
    }
  }
}

權限

1. 完全磁盤訪問權限：讀取語音備忘錄數據庫所需。
   • 轉到系統設置 > 隱私與安全 > 完全磁盤訪問權限。
   • 添加你的終端應用或 Claude Desktop。
2. 語音識別權限（用於轉錄）：
   • 僅在使用 transcribe_memo 工具時需要。
   • 首次使用時系統會提示。

MCP 工具

list_voice_memos

列出所有帶有元數據的語音備忘錄。 參數：

• limit（可選）：最大結果數（1 - 100，默認值：50）
• offset（可選）：分頁偏移量
• search（可選）：按標題過濾的搜索詞

示例響應：

{
  "memos": [
    {
      "id": 1,
      "title": "會議記錄",
      "date": "2025-01-07T10:30:00.000Z",
      "duration": 120.5,
      "hasTranscript": true
    }
  ],
  "total": 15
}

get_voice_memo

獲取特定備忘錄的詳細元數據。 參數：

• id（必需）：備忘錄 ID

get_audio

檢索音頻文件。 參數：

• id（必需）：備忘錄 ID
• format（可選）："path" 或 "base64"（默認值："path"）

get_transcript

從備忘錄中提取轉錄內容。 參數：

• id（必需）：備忘錄 ID
• format（可選）："text"、"json" 或 "timestamped"

transcribe_memo

使用 SFSpeechRecognizer 轉錄備忘錄。 參數：

• id（必需）：備忘錄 ID
• language（可選）：語言代碼（默認值："en-US"）

工作原理

數據訪問

語音備忘錄數據存儲在以下位置：

• 數據庫：~/Library/Group Containers/group.com.apple.VoiceMemos.shared/Recordings/CloudRecordings.db
• 音頻文件：同一目錄，.m4a 格式

轉錄內容存儲

Apple 使用名為 tsrp 的自定義 MPEG - 4 原子將轉錄內容直接存儲在 .m4a 音頻文件中。此 MCP 服務器會解析這些原子以提取轉錄內容，不存在單獨的轉錄文件。

開發

# 克隆倉庫
git clone https://github.com/jwulff/apple-voice-memo-mcp.git
cd apple-voice-memo-mcp

# 安裝依賴
npm install

# 構建
npm run build

# 在開發環境中運行
npm run dev

# 使用 MCP 檢查器進行測試
npm run inspector

故障排除

"未找到語音備忘錄數據庫"

1. 確保你至少打開過一次語音備忘錄應用。
2. 為你的終端/應用授予完全磁盤訪問權限。
3. 檢查語音備忘錄是否啟用了 iCloud 同步。

"沒有可用的轉錄內容"

• 在 macOS Sequoia+ 系統上，在語音備忘錄應用中打開備忘錄以觸發自動轉錄。
• 較舊的 macOS 版本沒有自動轉錄功能。
• 使用 transcribe_memo 工具通過 SFSpeechRecognizer 生成轉錄內容。

原生模塊綁定錯誤

如果你看到有關缺少 better_sqlite3.node 綁定的錯誤：

npm rebuild better-sqlite3

這會為你當前的 Node.js 版本重新編譯原生模塊。

📄 許可證

本項目採用 MIT 許可證。