📸 Smart Photo Journal MCP Server

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

スマートフォトジャーナルは、強力で直感的なツールを使って、写真ライブラリの検索や分析をサポートするために設計された MCP サーバーです。家族との思い出を振り返るときも、友人と写った特定の写真を探すときも、このサーバーにお任せください！🎉

着想元： burningion/video-editing-mcp MCP をクリエイティブなメディア管理に活用する革新的なアイデアを考案した @burningion に心から感謝します！

🎯 機能

• 場所で検索： 特定の場所で撮影した写真を簡単に見つけられます。🌍
• ラベルで検索： 「誕生日」、「ビーチ」、「休暇」などのキーワードやラベルで写真を検索できます。🎉
• 人物で検索： 特定の人物が写っている写真をすばやく見つけられます。👥
• 写真の分析： 写真を撮影することが多い時間帯や曜日など、興味深い傾向を把握できます。🕰️
• あいまい検索： 正確な名前がわからなくても大丈夫です！柔軟に検索できるよう、サーバーはあいまい検索に対応しています。🔍

🚀 はじめに

前提条件

1. macOS と写真ライブラリがあることを確認してください。
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> を、実際のデバイスのユーザー名とクローンしたディレクトリのパスに置き換えてください。 サーバーによる写真へのアクセスを許可するためのポップアップが表示されます。アクセスはローカルに限定され、Claude のサービス以外にデータが共有されることはありません。

MCP サーバーの初期化

サーバーが起動すると、次のように表示されます。

Starting Smart Photo Journal MCP server.

これで、写真に関するクエリを処理する準備が整いました！🎉

---

🛠️ 使用方法

利用可能なツール

1. 場所で検索

   • 説明：特定の場所で撮影した写真を見つけます。
   • 入力例：

     {
       "location": "Udaipur"
     }
     

   • 出力例：

     Udaipur で撮影された写真が 5 枚見つかりました：
     📷 IMG_1234.jpg
     ...
     

2. ラベルで検索

   • 説明：ラベルやキーワードで写真を検索します。
   • 入力例：

     {
       "label": "Birthday"
     }
     

   • 出力例：

     「Birthday」のラベルが付いた写真（3 枚）：
     📷 IMG_5678.jpg
     ...
     

3. 人物で検索

   • 説明：特定の人物が写っている写真を見つけます。
   • 入力例：

     {
       "person": "Maa"
     }
     

   • 出力例：

     Maa が写っている写真（10 枚）：
     📷 IMG_9101.jpg
     ...
     

4. 写真の分析

   • 説明：写真ライブラリの傾向を分析します。たとえば、写真を撮影することが多い時間帯や曜日を調べられます。
   • 入力例：

     {}
     

   • 出力例：

     📸 写真撮影の傾向：
     写真の合計：200
     ...
     

---

📚 使用例

1. 家族や友人のアルバムを整理

家族との思い出を一か所に集めたいですか？people-search ツールで「Papa」、「Mom」、「Any Friend」などの名前を使うと、特定の人物が写っている写真を見つけられます。

2. 休暇のハイライト

location-search ツールを使って、休暇で訪れた場所の写真を検索できます。

3. 懐かしい思い出を楽しむ

過去の誕生日の写真が気になりますか？label-search で「Birthday」を検索して、楽しかった思い出を振り返りましょう！

4. 写真撮影の習慣を知る

photo-analysis ツールを使うと、写真を撮ることが多い時間や場所を把握できます。それを参考に、次の撮影を計画しましょう！

---

⚡ 最良の結果を得るためのヒント

• macOS で写真ライブラリが読み込まれていることを確認してください。
• より正確な結果を得るために、検索クエリはできるだけ具体的にしてください。
• 正確な名前がわからない場合は、柔軟に検索できるファジーマッチングを使用してください。