Memory Journal MCP Server

📸 スマートフォトジャーナル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. PhotosライブラリがmacOSに読み込まれていることを確認します。
2. ターミナルを開き、サーバーのディレクトリに移動します：

cd /Users/<YOUR_DEVICE_USERNAME>/memory-journal-mcp-server

3. サーバーを実行します：

uv run server.py

高度な使用法

位置検索

• コマンド: location-search <地点>
• 例: location-search ニューヨーク
• 説明: 特定の場所のすべての写真を検索します。

タグ検索

• コマンド: label-search <タグ>
• 例: label-search 誕生日
• 説明: 指定したタグで写真を検索します。

人物検索

• コマンド: person-search <名前>
• 例: person-search 王伟
• 説明: 特定の人物が写っている写真を検索します。

写真分析

• コマンド: photo-analysis
• 例: photo-analysis
• 説明: 撮影時間、場所、頻度を分析し、統計結果を出力します。

具体的な使用シナリオ

1. 家族の思い出を振り返る

person-search を使用して家族が写っている写真を見つけます：

person-search 家族

2. 旅行の写真を検索する

location-search を使用して旅行先の写真を見つけます：

location-search 京都

3. 誕生日パーティーの写真を振り返る

label-search を使用して誕生日関連の写真を見つけます：

label-search 誕生日

💡 使用建议

• PhotosライブラリがmacOSに読み込まれていることを確認してください。
• より正確な結果を得るために、具体的な検索語を提供することをおすすめします。
• 曖昧検索機能を活用すると、スペルが間違っていても関連する結果を見つけることができます。

以上の手順とツールを使って、写真ライブラリの管理、検索、分析を簡単に行い、スマートフォトジャーナルの便利さをお楽しみください！