Home Memory

Home Memory

家に尋ねましょう。

ご自宅のあらゆることを記憶する、AI アシスタントのためのメモリーです。

技術的な説明を避けた紹介をご希望ですか？ home-memory.comをご覧ください。

Home Memory MCP は無料の独立したオープンソースのMCP サーバーで、自宅についての体系的で永続的な情報を AI アシスタントに提供します。部屋、機器、配管、ケーブル、所有している物などを記録できます。このリポジトリには、そのサーバーが含まれています。

ChatGPT デスクトップアプリ、Claude Desktop、Claude Code、Codex CLI など、MCP 対応の AI アプリで利用できます。自然な言葉で話しかけると、AI が Home Memory のツールを通じて自宅のデータを読み書きします。

現状を記録し、これからの計画を立て、取り外したものも把握できます。

この MCP ワークフローでは、アシスタントがインターフェースになります。自宅のデータはお使いのマシン上の単一ファイルに保存されます。アシスタントによっては、読み取った情報がその AI プロバイダーに送信される場合があります。

写真や書類のリンク、再利用可能な製品情報、メンテナンス作業指示書を備えた Windows ワークスペースをお探しですか？Home Memory Studioには、これらの機能と拡張版の専用 MCP が含まれています。Studio は単独で動作し、別途 Home Memory MCP をインストールする必要はありません。Studio はプロプライエタリーソフトウェアで、早期アクセス期間中は無料です。Windows 版のダウンロードは Studio のページから入手できます。

すでにこの MCP をお使いで、Studio の利用を検討していますか？データベースの別コピーの作成や Studio MCP のセットアップを含む、既存の記録を移行するためのガイドをご覧ください。

新たな計画から、役立つ住宅情報へ

この架空の住宅では、地下の設備室から東側の外壁まで、空の配管が 2 本すでに記録されています。エアコンは注文したばかりで、設置はこれからです。

1. 注文確認書とともに計画を記録します：

リビングとダイニング用に、このエアコンを注文しました。室外機は東側の外壁に設置します。設置予定として記録してください。

アシスタントは Daikin FTXM35A の室内機と RXM35A の室外機を予定の場所に記録し、両方を設置予定として登録します。

2. 新しい会話を始めます：

どのエアコンを選びましたか？設備室から設置予定の室外機の場所まで、予備の配管はありますか？経路と記録されている直径も教えてください。

アシスタントは選定した型番と、空いている 20 m の配管 2 本を取得します。記録されている呼び外径はそれぞれ 25 mm と 40 mm です。どちらも地下の天井に沿って東側の設備シャフトを通り、外壁まで続いています。新しい計画と既存の住宅記録が、以前の会話をコピーすることなく結び付きます。これらは施工業者と相談するために記録された経路であり、適合性を保証するものではありません。

この例では独立版の MCP を使用しています。Studio の使用例では、エアコンを設置した後の、同じ架空の住宅の様子をご覧いただけます。

できること

話しかけるだけで、どんな情報でも記録できます：

「ユーティリティルームにDaikin Althermaのヒートポンプがあります。」

AIが適切なカテゴリーを見つけ、場所を特定して、項目を作成します。手動でデータを入力する必要はありません。

「私の車は2023 Toyota Corolla Hybridで、次回の車検は3月です。」

建物の設備だけではありません。車両、工具、家電製品、貴重品など、自分が所有するものなら何でも記録できます。

家について質問できます：

「地下室には何がありますか？」 · 「購入予定のものをすべて表示してください。」 · 「洗濯機はどこにありますか？」

写真をアップロードして、AIに識別してもらえます：

(デバイスの写真を添付) 「これは何ですか？ユーティリティルームに追加してください。」

画像認識機能を備えたAIがデバイスを認識し、MCP経由で項目を作成します。

請求書を読み取り、デバイスを抽出できます：

(PDFの請求書を添付) 「設置済みのデバイスを抽出して、家に追加してください。」

AIクライアントが添付ファイルを読み取り、関連する詳細を記録します。スタンドアロンのMCPは、アップロードされた写真やPDFをリンクファイルとして保存しません。リンクされた画像やドキュメントはStudioで利用できます。

項目間の経路を記録できます：

「分電盤からキッチンのコンセントへ、NYM-J 3x1.5で配線されています。」

ケーブルの経路、配管の経路、ダクトの経路を、項目間の線として記録できます。

改修を計画できます：

「屋根にPVシステムを設置する予定です。」 · 「古い石油暖房機は昨年撤去しました。」

計画中のもの、現在あるもの、撤去済みのものを記録できます。

クイックスタート（Windows）

スタンドアロン版のHome Memory MCPをインストールします。Studioと付属のMCPを使う場合は、代わりにStudioのスタートガイドをご覧ください。

リリースZIPは自己完結型です。.NETやFirebirdのインストールは不要です。以下に記載されたローカルAIクライアントのいずれかが必要です。

ローカルAIでセットアップする

Windows PCでCodexまたはClaude Codeをローカルでお使いですか？Home Memoryのインストールと設定を任せることができます。次のプロンプトを貼り付けてください。

このWindows PCに、https://github.com/impactjo/home-memory からHome Memoryをセットアップしてください。READMEとセットアップガイドに従い、最新の公式リリースZIPを使用して、現在使用中のローカルAIクライアントに登録してください。まず、Home Memoryがすでにインストールまたは登録されているか確認してください。既存のクライアント設定とHome Memoryデータベースは保持し、既存の登録がある場合は重複を作成せずに更新してください。ダウンロードしたリリースに skills\home-memory-documentation が含まれており、このクライアントがAgent Skillsに対応している場合は、そのディレクトリをユーザーレベルのスキルとしてインストールしてください。インストールするスキルファイルは、既存の開発用コピーではなく、ダウンロードしたリリースに含まれるものを使用してください。リリースにそのディレクトリが含まれていない場合は、スキルなしでMCPのセットアップを完了し、任意のドキュメントスキルがインストールされなかったことを報告してください。既存のインストールの置き換えやデータベースの移行を行う前に、明示的な確認を求めてください。登録後、MCP接続を確認してください。サーバーとドキュメントスキルがインストールされたかどうか、またクライアントの再起動または新しいセッションの開始が必要かどうかを教えてください。

MCPサーバーにより、AIはローカルのHome Memoryデータベースにアクセスできます。任意のドキュメントスキルを追加すると、記録を構成するためのルールが加わります。リリースZIPに skills\home-memory-documentation が含まれている場合、このディレクトリをユーザーレベルのスキルとしてインストールできます。Agent Skillsに対応していないクライアントや、そのディレクトリが含まれていない古いリリースでも、MCPサーバーは使用できます。

スキルを別途インストールするには、Agent Skillsに対応したクライアントに、このリポジトリの skills/home-memory-documentation をユーザーレベルのスキルとしてインストールするよう依頼してください。

登録後、接続を確認するために 3. 試してみる に進んでください。

自分でセットアップしますか？以下の 1. ダウンロードと展開 に進んでください。

1. ダウンロードと展開

1. GitHub Releasesから最新のリリースZIPをダウンロードします
2. C:\HomeMemory\ などのフォルダーに展開します

2. AI に接続する

次のクライアントから1つ選び、Home Memory を展開したコンピューター上でローカルセッションを使用します。クラウドセッションから、このインストール環境に自動的にアクセスすることはできません。同じコンピューターにスマートフォンからアクセスする方法については、下記の 4. スマートフォンから使用するを参照してください。

codex mcp add home-memory -- "C:\HomeMemory\HomeMemoryMCP.exe"

{
  "mcpServers": {
    "home-memory": {
      "command": "C:\\HomeMemory\\HomeMemoryMCP.exe"
    }
  }
}

claude mcp add home-memory --scope user -- "C:\HomeMemory\HomeMemoryMCP.exe"

3. 試してみる

初回起動時に、Home Memory は100を超えるカテゴリと初期のサンプル構造（階、部屋、ガレージ、屋外エリア）を含むローカルデータベースを自動的に作成します。セットアップウィザードは不要です。

まず、AI が Home Memory を使用できることを確認します：

「Home Memory MCP ツール get_structure_overview を使って、現在 Home Memory に保存されている構造を表示してください。ツールを利用できない場合は、推測せずにそう伝えてください。」

1階、2階、地下室、複数の部屋を含む初期サンプル構造が表示されるはずです。これにより、クライアントが Home Memory のツールを検出して呼び出せることを確認できます。

Home Memory が利用できない場合、またはエラーが報告された場合は、トラブルシューティングを参照してください。

これがうまくいったら、通常は Home Memory や個別のツール名に言及する必要はありません。自然な言葉で続けてください：

「地下室に Bosch の洗濯機があります。」

AI が要素を作成し、適切なカテゴリを見つけて、地下室に配置します。これらをすべて1つの手順で行います。「地下室には何がありますか？」と尋ねて確認してください。

「ユーティリティルームにヒートポンプを設置する予定です。」

予定の要素が作成され、現在あるものと今後追加されるものを記録できます。

**問題なく動作したら、セットアップは完了です。**ここからは、AI と自然な言葉でやり取りしながら、サンプル構造を調整したり、家電、家具、ツールを追加したり、写真や請求書から詳細を記録したりできます。

4. スマートフォンから使う（任意）

Home Memory はローカルで動作しますが、Claude Code または ChatGPT デスクトップアプリのリモートアクセスを通じて、スマートフォンから利用できます。どちらの場合も、Home Memory のデータベースと MCP サーバーはお使いのマシン上に残り、スマートフォンはそのホスト上で動作しているセッションにリモートからアクセスするための画面として使われます。

パソコンから離れているときに、何かを調べたり、その場で記録したりするのに便利です。たとえば、ヒューズボックスの前や庭にいるとき、新しい家電の写真を撮るときなどに活用できます。

• Claude Code： ローカルセッションを開始し、リモートコントロールを有効にしてから、Claude モバイルアプリまたは claude.ai/code でセッションを続けます。Claude アカウントへのサインインが必要です。
• ChatGPT デスクトップアプリ： ホストマシンでリモートセットアップを開始し、ChatGPT モバイルアプリで表示された QR コードをスキャンしてスマートフォンをペアリングします。

ソースからビルドする（上級者向け）

前提条件、ビルドコマンド、Firebird の設定については、セットアップガイドのソースからのビルドをご覧ください。

仕組み

You ──── AI Assistant ──── Home Memory MCP ──── Local Database
(natural language)           (24 tools)    (Firebird, single file)

Home Memory はModel Context Protocol（MCP）を実装しています。これは、AI アシスタントが外部ツールを使えるようにするオープン標準です。自宅について AI と話すと、AI はバックグラウンドで Home Memory のツールを呼び出し、自宅のデータの読み取り、作成、更新、検索を行います。

データはローカルに保存されます。 データベースはお使いのマシン上の単一ファイルです。すでに会話している AI 以外に、データが送信されることはありません。

機能

24 個の MCP ツール

あらゆる分野を網羅し、ニーズに合わせて自由にカスタマイズできます

電気（回路、太陽光発電、EV 充電器、ホームオートメーション）・空調・配管・IT／通信・セキュリティ（警報、火災、監視）・建材・造園（庭、プール、灌漑）・家庭用品（家電、家具、貴重品）・車両・工具・健康・スポーツ／レジャー

すべてのカテゴリ、要素、ステータスを編集できます。自宅の捉え方に合わせて、名前の変更、追加、削除ができます。

スマートな初期設定

• 100以上のカテゴリを業種や分野ごとに整理。ブレーカーから庭のスプリンクラー、車両まで対応します
• 標準の住宅構成として、階、部屋、ガレージ、屋外エリアを用意。AI との会話でカスタマイズできます
• 初回実行時に自動セットアップされるため、データベースを手動で作成する必要はありません
• 柔軟な名前付け： AI は「Ground Floor」や「GF」を使えます。サーバーがどちらも識別します

互換性

リリース ZIP は、依存関係をすべて含む自己完結型の Windows ビルドです（.NET や Firebird のインストールは不要です）。macOS と Linux では、.NET 10 と Firebird 3 を使ってソースからビルドできます。詳しくはセットアップガイドをご覧ください。

設定

HTTP モード（LAN、任意）

デフォルトは Stdio で、ほとんどのユーザーに適しています。HTTP モードでは、Home Memory を NAS、ホームラボ用マシン、または LAN 上の別のマシンで永続的なサービスとして実行できます。セットアップ、データベースのロック、LAN アクセス、HTTP のセキュリティ要件については、docs/HTTP-MODE.md をご覧ください。

アーキテクチャ

• ModelContextProtocol SDK を使用した .NET 10
• Firebird Embedded：ローカルデータベースエンジン、単一ファイルでのストレージ
• 生の SQL と再帰 CTE を使用し、ORM のオーバーヘッドがなく、透明性と監査可能性を備えています

コントリビューション

Home Memory は継続的に進化しており、フィードバックを歓迎しています。現在、コントリビューションとして最適な方法は次のとおりです。

• イシューを作成する：バグ報告、機能のアイデア、質問を投稿してください
• ユースケースを共有する：Home Memory をどのように使っていますか？不足しているものは何ですか？
• 役に立つと思ったら、情報を広めてください

ローカルでコードをビルドして確認したい場合は、セットアップガイドをご覧ください。

背景

Home Memory は、物理資産を記録するデスクトップアプリである Smartconstruct の実績あるデータモデルを基盤としており、住宅建設プロジェクトでの実運用を通じて改良されています。

ライセンス

AGPL-3.0

home-memory.com