Icloud Photos

🚀 スマートフォトジャーナル MCP サーバー

スマートフォトジャーナル は MCP サーバーで、強力で直感的なツールを通じて、あなたの写真ライブラリの検索と分析をサポートします。家族の思い出を振り返るときでも、友人と特定の写真を探すときでも、このサーバーがあなたの助けになります！🎉

インスピレーション元: burningion/video-editing-mcp @burningion 氏が MCP を使ったクリエイティブメディア管理の素晴らしいアイデアを提案してくれたことに、深く感謝いたします！

✨ 主な機能

• 位置検索: 特定の場所の写真を簡単に見つけることができます。🌍
• タグ検索: キーワードやタグ（例：「誕生日」、「ビーチ」、「休暇」）で写真を検索できます。🎉
• 人物検索: 特定の人物が写っている写真をすばやく見つけることができます。👥
• 写真分析: 面白い洞察を発見できます。例えば、あなたが最も多く撮影した時間帯や日付などです。itime️
• 曖昧検索: 正確な名前がわからなくても心配しないでください！このサーバーは曖昧検索に対応しており、柔軟性を提供します。🔍

🚀 クイックスタート

前提条件

1. あなたのデバイスが macOS を実行し、Photos ライブラリを持っていることを確認してください。
2. 依存関係を管理し、サーバーを実行するために uv をインストールしてください。

インストール手順

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

   git clone https://github.com/Siddhant-K-code/memory-journal-mcp-server.git
   cd memory-journal-mcp-server
   

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

   uv sync
   

3. MCP サーバーを設定します。claude_desktop_config.json ファイルを更新し、以下の設定を追加します。

   {
     "mcpServers": {
       "smart-photo-journal": {
         "command": "/Users/<YOUR_DEVICE_USERNAME>/.local/bin/uv",
         "args": [
           "--directory",
           "/Users/<PATH_TO_CLONED_DIR>/memory-journal-mcp-server",
           "run",
           "server.py"
         ]
       }
     }
   }
   

4. 以下のコマンドを使うか、直接 Claude Desktop を開いてサーバーを起動します。

   uv run server.py
   

⚠️ 重要提示

<YOUR_DEVICE_USERNAME> と <PATH_TO_CLONED_DIR> を実際のユーザー名とクローンしたディレクトリのパスに置き換えてください。

💻 使用例

基本的な使用法

• 位置検索: 地理位置を入力すると、関連する写真をすばやく見つけることができます。
• タグ検索: キーワードやタグを使って正確に検索できます。例えば、「誕生日」と入力すると、すべての誕生日関連の写真が取得できます。
• 人物検索: 人名や他の識別子を使って特定の人物の写真を検索できます。
• 写真分析: あなたの撮影習慣の分析を取得できます。最も多く撮影した時間帯や人気の場所などの情報が含まれます。
• 曖昧検索: 検索キーワードがわからないときは、近似語を使って検索できます。システムが自動的に関連する結果を提案します。

具体的な使用シーン

1. 家族の思い出

• 特定の家族の写真を検索します。例えば、「お母さん」や「お父さん」と入力すると、すべての関連する写真をすばやく見つけることができます。
• 過去数年間の誕生日パーティーを振り返ります。「誕生日」というタグを入力するだけで、簡単に見つけることができます。

2. 旅行の記録

• 旅行先を基に検索します。例えば、「パリ」や「東京」と入力すると、旅行の思い出を整理することができます。
• 異なる旅行先での撮影頻度を分析し、あなたの好みを把握することができます。

3. 仕事のニーズ

• 写真家やコンテンツクリエイターは、タグを使って素材をすばやく分類し、管理することができます。
• 写真分析機能を使って、撮影計画や時間の配分を最適化することができます。

💡 使用建议

• 最良の体験を得るために、あなたの Photos ライブラリが macOS に読み込まれていることを確認してください。
• 検索するときは、具体的なキーワードを使うと、結果の精度が向上します。
• 曖昧な検索キーワードの場合、曖昧検索機能を利用すると、検索効率が向上します。