MCP Apple Notes について
MCP Apple Notes は Apple Notes のセマンティック検索と全文検索に加え、ノートの取得と作成を提供します。Cursor IDE などの MCP クライアントからノートにアクセスしたい macOS ユーザー向けです。
主な機能
- 01オンデバイス埋め込みモデルによる意味検索
- 02全文検索とキーワード検索
- 03LanceDBによるベクトル保存
- 04ノートの一覧表示と取得
- 05ノートの作成
活用シーン
- 01意味やキーワードからノートを検索
- 02タイトルを指定してノートを取得
- 03意味検索用にノートをインデックス化
- 04MCP クライアントからノートを作成
MCP 対応
Apple Notes の一覧表示、インデックス作成、検索、取得、作成をツールとして MCP クライアントに公開します。README では Cursor IDE での設定方法を説明しています。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
このサーバーのパッケージやリモートエンドポイントはまだ取得できていません。プロジェクトの README の手順に従ってください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
MCP Apple Notes
Apple Notes 内をセマンティック検索および取得するための Model Context Protocol(MCP)サーバーです。
機能
- 🔍 デバイス上の埋め込みモデルを使用したセマンティック検索
- 📝 全文検索機能
- 💾 LanceDB によるベクトルストレージ
- 🍎 Apple Notes とのネイティブ連携
前提条件
- macOS(Apple Notes との連携に必要)
- Bun JavaScript ランタイム
インストール
- このリポジトリをクローンします:
git clone https://github.com/Dingzeefs/mcp-apple-notes.git
cd mcp-apple-notes
- 依存関係をインストールします:
bun install
使用方法
Cursor IDE での設定
-
Cursor IDE を開きます
-
「設定」→「機能」→「MCP」に移動します
-
以下の設定で新しい MCP サーバーを追加します:
- 名前:Apple Notes
- 種類:command
- コマンド:
/path/to/bun /path/to/mcp-apple-notes/index.ts
/path/to/bunを Bun 実行ファイルの実際のパス(which bunで確認できます)に置き換え、/path/to/mcp-apple-notesをこのリポジトリの実際のパスに置き換えてください。 -
Cursor IDE を再起動します
MCP サーバーの使用
設定が完了すると、Claude との会話で次のツールを使用できます:
- list-notes:Apple Notes のすべてのタイトルを一覧表示します
- index-notes:セマンティック検索用にメモをインデックス化します(最初に実行してください)
- get-note:タイトルを指定して特定のメモを取得します
- search-notes:セマンティック検索またはキーワード検索を使用してメモを検索します
- create-note:指定したタイトルと内容で新しいメモを作成します
トラブルシューティング
問題が発生した場合:
- Cursor の MCP サーバーの状態を確認し、サーバーが実行中であることを確認します
- MCP サーバーの設定にあるパスが正しいことを確認します
- ターミナルでコマンドを直接実行し、エラーメッセージがないか確認します
- Apple Notes にアクセスでき、必要な権限が付与されていることを確認します
ライセンス
MIT
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。