Siddhant K Code Memory Journal MCP Server

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

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

インスピレーションの源: burningion/video - editing - mcp @burningion 氏に大きな感謝を！MCPを使った創造的なメディア管理の革新的なアイデアを提供してくれました！

🚀 クイックスタート

前提条件

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> を実際のデバイスのユーザー名とクローンしたディレクトリのパスに置き換えてください。サーバーがあなたの写真にアクセスする許可を求めるポップアップウィンドウが表示されます。このサーバーはローカルでのみ実行され、Claudeサービス以外にはデータを共有しません。

MCPサーバーの初期化

サーバーが起動すると、以下のメッセージが表示されます：

正在启动智能照片日志 MCP 服务器。

これで、あなたの写真クエリを処理する準備ができました！🎉

✨ 主な機能

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

💻 使用例

基本的な使用法

利用可能なツール

1. 位置検索
   • 説明：特定の場所で撮影された写真を検索します。
   • 入力例：

     {
       "location": " udaipur"
     }
     

   • 期待される出力：

     在 Udaipur 找到 5 张照片：
     📷 IMG_1234.jpg
     ...
     

2. タグ検索
   • 説明：タグまたはキーワードで写真を検索します。
   • 入力例：

     {
       "label": "Birthday"
     }
     

   • 期待される出力：

     找到标签为“Birthday”的照片：
     📷 IMG_5678.jpg
     ...
     

3. 人物検索
   • 説明：特定の人物が写っている写真を検索します。
   • 入力例：

     {
       "person": "Alice"
     }
     

   • 期待される出力：

     找到 Alice 的照片：
     📷 IMG_9012.jpg
     ...
     

4. 写真分析
   • 説明：写真を撮影した時間、場所、頻度についての情報を取得します。
   • 入力例：

     {
       "analysis": "summary"
     }
     

   • 期待される出力：

     - 最常拍摄的日期：2023 - 10 - 01
     - 最常拍摄的位置：New York
     - 拍摄最活跃的时间段：傍晚时分
     

💡 使用建议

• macOSのPhotosライブラリが読み込まれていることを確認してください。
• より正確な結果を得るために、検索クエリをできるだけ具体的にしてください。
• 正確な名前がわからない場合は、曖昧検索を使用してください。