MCP Apple Notes

🚀 MCP アップルノートサーバ

モデルコンテキストプロトコル (MCP) を用いた、セマンティック検索と RAG（拡張検索生成）をサポートするサーバです。これにより、AI アシスタント（Claude など）が会話中にあなたのアップルノートを検索し、引用することができます。

✨ 主な機能

• 🔍 デバイス上の埋め込みモデル all-MiniLM-L6-v2 を使用したセマンティック検索
• 📝 全文検索機能
• 📊 ベクトルストレージに LanceDB を使用
• 🤖 AI アシスタントと統合された MCP 互換サーバ
• 🍎 JXA を通じた原生のアップルノート統合
• 🏃♂️ 完全なローカル実行 - API キー不要

📦 インストール

前提条件

• Bun
• Claude Desktop

インストール手順

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

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

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

bun install

💻 使用例

基本的な使用法

1. Claude デスクトップアプリを開き、設定 -> 開発者 -> 設定を編集 を選択します。
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. ノートのインデックス作成を開始します。Claude に「索引我的笔记」または「索引我的苹果笔记」と言うことで、インデックス作成を開始できます。

トラブルシューティング

ログを確認するには、以下のコマンドを実行します：

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

今後の予定

• [ ] アップルノートを HTML 形式で返す。Markdown に変換して埋め込む必要がある
• [ ] ソースコンテンツを再帰的なテキスト分割器または Markdown テキスト分割器を使用してチャンク化する
• [ ] カスタム埋め込みモデルを使用するオプションを追加する
• [ ] より多くのデータベース制御 - データベースの削除、カスタムクエリなど
• [x] Claude を通じてノートを保存する