Smart Photo Journal MCP Server

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

Smart Photo Journalは、パワフルで直感的なツールを使って写真ライブラリを検索・分析できる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 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 サーバーの初期化

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

写真クエリを処理する準備ができました！🎉

🛠️ 使用方法

利用可能なツール

1. 場所検索
   • 説明: 特定の場所で撮影された写真を検索します。
   • 入力例:
     { "location": "Udaipur" }
   • 期待される出力:
     Found 5 photos from Udaipur: 📷 IMG_1234.jpg ...
2. ラベル検索
   • 説明: ラベルまたはキーワードで写真を検索します。
   • 入力例:
     { "label": "Birthday" }
   • 期待される出力:
     Photos labeled as 'Birthday' (3 found): 📷 IMG_5678.jpg ...
3. 人物検索
   • 説明: 特定の人物が写っている写真を検索します。
   • 入力例:
     { "person": "Maa" }
   • 期待される出力:
     Photos with Maa (10 found): 📷 IMG_9101.jpg ...
4. 写真分析
   • 説明: 写真撮影に最もよく使用される時間や曜日など、写真ライブラリ内のパターンを分析します。
   • 入力例:
     {}
   • 期待される出力:
     📸 Photo Taking Patterns: Total Photos: 200 ...

📚 ユースケースの例

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

家族の思い出を一か所に集めたいですか？「パパ」「ママ」「友達」などの名前でpeople-searchツールを使って、特定の人が写っている写真を探しましょう。

2.休暇のハイライト

location-searchツールを使用して、休暇先の写真を検索します。

3.懐かしい思い出を振り返る

過去の誕生日の写真が気になりますか？「誕生日」のlabel-searchを使って、楽しい思い出をもう一度思い出しましょう！

4.自分の写真撮影の習慣を理解する

photo-analysisツールを使えば、自分が最もよく写真を撮った時間と場所を把握できます。次の撮影では、それに基づいて計画を立てましょう。

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

• macOS にフォトライブラリが読み込まれていることを確認します。
• より正確な結果を得るために、検索クエリをできるだけ具体的にしてください。
• 正確な名前がわからない場合は、柔軟に対応するためにあいまい一致を使用します。