MCP Apple Notes

MCP Appleノート

Apple Notes 上でセマンティック検索と取得を行うための Model Context Protocol (MCP) サーバー。

特徴

• 🔍 デバイス上の埋め込みモデルを使用したセマンティック検索
• 📝 全文検索機能
• 💾 LanceDB によるベクトルストレージ
• 🍎 ネイティブ Apple Notes 統合

前提条件

• macOS（Apple Notes の統合に必要）
• Bun JavaScript ランタイム

インストール

1. このリポジトリをクローンします:

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

使用法

カーソルIDEでの設定

1. オープンカーソルIDE
2. 設定→機能→MCPに移動します
3. 次の構成で新しい MCP サーバーを追加します。
   • 名前: Apple Notes
   • タイプ: コマンド
   • コマンド: /path/to/bun /path/to/mcp-apple-notes/index.ts``/path/to/bun Bun 実行可能ファイルへの実際のパス ( which bunを使用して検索) に置き換え、 /path/to/mcp-apple-notesをこのリポジトリへの実際のパスに置き換えます。
4. カーソルIDEを再起動

MCPサーバーの使用

設定が完了すると、Claude との会話で次のツールを使用できるようになります。

• list-notes : Apple Notesのタイトルをすべて一覧表示します
• index-notes : セマンティック検索用にノートをインデックスします（最初にこれを実行してください）
• get-note : タイトルで特定のノートを取得します
• search-notes : セマンティック検索またはキーワード検索を使用してノートを検索します
• create-note : 指定されたタイトルと内容で新しいノートを作成します

トラブルシューティング

問題が発生した場合:

1. カーソルのMCPサーバステータスを見て、サーバが実行中であることを確認します。
2. MCPサーバー構成のパスが正しいことを確認してください
3. エラーメッセージを確認するには、ターミナルで直接コマンドを実行してみてください。
4. Apple Notes にアクセスでき、権限が付与されていることを確認してください

ライセンス

マサチューセッツ工科大学