MCP Apple Notes

MCP Apple Notes

Apple Notes を対象としたセマンティック検索と RAG（Retrieval Augmented Generation）を可能にする Model Context Protocol (MCP) サーバーです。Claude のような AI アシスタントが会話中に Apple Notes を検索し、参照できるようになります。

機能

• 🔍 オンデバイス埋め込みモデル all-MiniLM-L6-v2 を使用した、Apple Notes のセマンティック検索
• 📝 全文検索機能
• 📊 LanceDB を使用したベクトルストレージ
• 🤖 AI アシスタントと連携する MCP 対応サーバー
• 🍎 JXA を介した Apple Notes とのネイティブ連携
• 🏃‍♂️ 完全にローカルで実行でき、API キーは不要です

前提条件

• Bun
• Claude Desktop

インストール

1. リポジトリをクローンします。

git clone https://github.com/RafalWilinski/mcp-apple-notes
cd mcp-apple-notes

2. 依存関係をインストールします。

bun install

使い方

1. Claude デスクトップアプリを開き、「Settings」→「Developer」→「Edit Config」に移動します。

2. claude_desktop_config.json を開き、次のエントリを追加します。

{
  "mcpServers": {
    "local-machine": {
      "command": "/Users/<YOUR_USER_NAME>/.bun/bin/bun",
      "args": ["/Users/<YOUR_USER_NAME>/apple-notes-mcp/index.ts"]
    }
  }
}

重要：<YOUR_USER_NAME> を実際のユーザー名に置き換えてください。

3. Claude デスクトップアプリを再起動します。次のように表示されます。

4. ノートのインデックス作成を始めます。「Index my notes」や「Index my Apple Notes」のように Claude に伝えて、ノートのインデックスを作成するよう依頼してください。

トラブルシューティング

ログを確認するには：

tail -n 50 -f ~/Library/Logs/Claude/mcp-server-local-machine.log
# or
tail -n 50 -f ~/Library/Logs/Claude/mcp.log

TODO

• Apple Notes は HTML 形式で返されます。Markdown に変換して埋め込む必要があります
• 再帰的テキスト分割または Markdown テキスト分割を使用して、ソースコンテンツをチャンクに分割する
• カスタム埋め込みモデルを使用するオプションを追加する
• DB をより細かく制御できるようにする（消去、カスタムクエリなど）
• Claude を介して Notes にノートを保存する