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。它可独立运行，无需单独安装 Home Memory MCP。Studio 是专有软件，目前在早期体验阶段免费提供。你可以在 Studio 页面获取 Windows 下载版。

已经在使用此 MCP，并在考虑 Studio？请参阅迁移现有文档的指南，其中介绍了如何单独复制数据库以及设置 Studio MCP。

从新计划到实用的家庭知识

在这个虚构的家中，地下室设备间通往东侧外墙的两根空导管已记录在案。空调刚刚下单，安装仍未进行。

1. 根据订单确认记录计划：

我们已为客厅和餐厅订购这台空调。室外机将安装在东侧外墙。请记录计划中的安装信息。

助手会记录 Daikin FTXM35A 室内机和 RXM35A 室外机的预定位置，并将两者都标记为计划安装。

2. 开始新的对话：

我们选了哪款空调？设备间到计划安装室外机的位置之间有没有空闲导管？请提供走向和记录的直径。

助手会检索选定的型号，以及两根空闲的 20 m 导管，其记录的公称外径分别为 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 电缆为厨房插座供电。”

电缆走向、管道走线和风管路径都可以记录为条目之间的线路。

规划翻新：

“我们计划在屋顶安装一套光伏系统。” · “旧燃油暖炉去年拆除了。”

跟踪哪些事项处于计划中、哪些已存在，以及哪些已拆除。

快速开始（Windows）

此安装程序会安装独立版 Home Memory MCP。如需使用 Studio 及其内置 MCP，请参阅 Studio 入门指南。

发布 ZIP 包是自包含的，无需安装 .NET 或 Firebird。你需要使用下方列出的本地 AI 客户端之一。

使用本地 AI 进行设置

已经在 Windows 电脑上本地使用 Codex 或 Claude Code？它可以帮助你安装和配置 Home Memory。粘贴以下提示词：

在这台 Windows 电脑上，从 https://github.com/impactjo/home-memory 设置 Home Memory。按照其 README 和 Setup Guide 操作，使用最新的官方发布 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

选择以下其中一个客户端，并在提取 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 中当前存储的结构。如果无法使用该工具，请直接告诉我，不要猜测。”

你应该会看到初始示例结构，包括一层、二层、地下室和几个房间。这表示客户端可以发现并调用 Home Memory 的工具。

如果 Home Memory 不可用或报告错误，请参阅故障排除。

确认正常后，通常无需提及 Home Memory 或具体工具名称。像平常一样交流即可：

“我在地下室有一台 Bosch 洗衣机。”

AI 会一步完成创建元素、找到合适的类别并将其放入地下室。询问“地下室里有什么？”进行确认。

“我们计划在杂物间安装一台热泵。”

这会创建一个计划中的元素，方便你追踪现有物品和即将添置的物品。

如果一切正常，设置就完成了。 接下来，你可以用自然语言与 AI 交流，调整示例结构，添加电器、家具或工具，并从照片或发票中记录详细信息。

4. 在手机上使用（可选）

Home Memory 在本地运行，但你可以通过 Claude Code 或 ChatGPT 桌面应用中的远程访问功能，在手机上使用它。两种情况下，Home Memory 数据库和 MCP 服务都保留在你的设备上；手机只是用于远程访问该设备上运行的会话。

当你离开电脑，需要随时查找信息或记录内容时，这项功能非常方便；无论你是在保险丝盒旁、花园里，还是在为新家电拍照。

• Claude Code： 启动本地会话，启用 Remote Control，然后通过 Claude 移动应用或 claude.ai/code 继续会话。需要登录 Claude 账户。
• ChatGPT 桌面应用： 在主机上启动 Remote setup，然后使用 ChatGPT 移动应用扫描屏幕上显示的二维码，将手机配对。

从源代码构建（高级）

有关先决条件、构建命令和 Firebird 配置，请参阅设置指南中的从源代码构建。

工作原理

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

Home Memory 实现了 Model Context Protocol (MCP)，这是一项开放标准，可让 AI 助手使用外部工具。当你与 AI 讨论家里的情况时，它会在后台调用 Home Memory 的工具，读取、创建、更新和搜索你的家庭数据。

你的数据保留在本地。 数据库是设备上的单个文件。除你正在使用的 AI 外，不会向任何地方发送数据。

功能

24 个 MCP 工具

覆盖所有领域，并可根据你的需求全面自定义

电气（电路、光伏、壁挂式充电桩、家庭自动化）· 暖通空调 · 管道 · IT 与通信 · 安全（警报、消防、监控）· 建筑材料 · 园林绿化（花园、泳池、灌溉）· 家居（家电、家具、贵重物品）· 车辆 · 工具 · 健康 · 体育与休闲

每个类别、每个元素和每种状态都可以编辑。你可以重命名、添加或移除任何内容，以符合你描述家庭情况的方式。

智能默认设置

• 100 多个类别，按行业和领域整理，涵盖从断路器、花园喷头到车辆等内容
• 默认房屋结构，包含楼层、房间、车库和户外区域，可通过与 AI 对话进行自定义
• 自动设置，首次运行时自动完成，无需手动创建数据库
• 灵活命名：AI 可以使用“Ground Floor”或“GF”，服务会识别两种写法

兼容性

发布 ZIP 是一个独立的 Windows 版本，包含所有依赖项（无需安装 .NET 或 Firebird）。在 macOS 和 Linux 上，你可以使用 .NET 10 和 Firebird 3 从源代码构建；详情请参阅设置指南。

配置

HTTP 模式（局域网，可选）

Stdio 是默认模式，适用于绝大多数用户。HTTP 模式可让你在 NAS、家庭实验室设备或局域网中的其他机器上，将 Home Memory 作为持久服务运行。有关设置、数据库锁定、局域网访问和 HTTP 安全要求，请参阅 docs/HTTP-MODE.md。

架构

• .NET 10，使用 ModelContextProtocol SDK
• Firebird Embedded：本地数据库引擎，采用单文件存储
• 使用原生 SQL 和递归 CTE，不引入 ORM 开销，透明且可审计

贡献

Home Memory 持续发展，欢迎反馈。目前，最佳的贡献方式是：

• 提交 issue，报告 bug、提出功能想法或问题
• 分享你的使用场景：你如何使用 Home Memory？还缺少什么？
• 如果觉得它有用，就帮忙宣传

如果你想在本地构建并探索代码，请参阅设置指南。

背景

Home Memory 基于 Smartconstruct 中经实践验证的数据模型构建。Smartconstruct 是一款用于记录实体资产的桌面应用，该数据模型经过住宅建筑项目的实际应用打磨。

许可证

AGPL-3.0

home-memory.com