my-local-storage-mcp：为 LLM 打造轻量级本地长期记忆方案

一个基于 MCP 协议的轻量级本地记忆服务器，使用 SQLite 实现零成本、毫秒级响应的持久化知识存储，让 AI 助手真正"记住"你的项目背景与决策。

• 原作者/维护者：avm-sistemas
• 来源平台：github
• 原始标题：my-local-storage-mcp
• 原始链接：https://github.com/avm-sistemas/my-local-storage-mcp
• 来源发布时间/更新时间：2026-06-01T18:43:08Z

原作者与来源

• 原作者/维护者：avm-sistemas
• 来源平台：github
• 原始标题：my-local-storage-mcp
• 原始链接：https://github.com/avm-sistemas/my-local-storage-mcp
• 来源发布时间/更新时间：2026-06-01T18:43:08Z 原作者与来源\n\n- 原作者/维护者：avm-sistemas\n- 来源平台：GitHub\n- 原项目名：my-local-storage-mcp\n- 原始链接：https://github.com/avm-sistemas/my-local-storage-mcp\n- 发布时间：2026-06-01\n\n---\n\n背景：LLM 的记忆困境\n\n大型语言模型（LLM）在对话中表现出的"健忘"一直是开发者头疼的问题。每次开启新对话，模型都需要重新了解项目背景、技术栈偏好、甚至之前已经讨论过的架构决策。虽然一些平台提供了记忆功能，但它们往往依赖云端存储，存在隐私顾虑，且难以与本地开发工作流深度整合。\n\nModel Context Protocol（MCP）是 Anthropic 推出的开放协议，旨在标准化 AI 助手与外部数据源、工具之间的交互方式。通过 MCP，开发者可以构建自定义服务器，为 AI 提供结构化的上下文信息。而 my-local-storage-mcp 正是基于这一协议，为 LLM 提供了一个轻量级的本地长期记忆解决方案。\n\n---\n\n项目概述\n\nmy-local-storage-mcp 是一个基于 Node.js 和 TypeScript 开发的 MCP 服务器，核心目标是让 LLM 拥有持久化的本地记忆能力。它使用 SQLite 作为存储后端，在用户的 home 目录下创建一个名为 .local_mcp_learning.db 的数据库文件，用于存储和管理知识条目。\n\n该项目的设计理念可以用"KISS"原则概括——保持简单、避免过度工程化。与那些需要部署向量数据库或复杂后台服务的方案不同，my-local-storage-mcp 仅依赖一个轻量级的 SQLite 文件，实现了零运维成本、毫秒级响应的本地知识存储。\n\n---\n\n核心机制与设计亮点\n\n1. 去中心化的索引策略\n\n项目采用了一种独特的"卸载式索引"（Offloaded Indexing）设计。与传统的数据库系统不同，my-local-storage-mcp 并不在本地运行复杂的 NLP 管道或嵌入模型来提取关键词和分类。相反，它将这些工作委托给 LLM 本身——通过严格的 JSON Schema 约束，让模型在存储知识时自动生成结构化的元数据。\n\n这种设计带来了几个好处：\n- 降低本地资源消耗：无需运行额外的 ML 模型或服务\n- 利用 LLM 的理解能力：模型可以根据上下文生成更准确、更相关的标签\n- 简化架构：减少了组件之间的依赖和故障点\n\n2. 数据库结构设计\n\nSQLite 数据库中的 local_learning 表结构清晰简洁：\n\nsql\nCREATE TABLE IF NOT EXISTS local_learning (\n id INTEGER PRIMARY KEY AUTOINCREMENT,\n topic TEXT NOT NULL,\n keywords TEXT NOT NULL,\n fact TEXT NOT NULL,\n created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP\n);\n\nCREATE INDEX IF NOT EXISTS idx_learning_lookup ON local_learning(topic, keywords);\n\n\n这种设计支持按主题和关键词进行高效检索，同时保持了数据模型的简单性。\n\n3. 零运维成本\n\n项目完全在本地硬件上运行，无需任何外部 API 调用或云服务。这意味着：\n- 绝对的数据隐私：敏感信息不会离开本地机器\n- 无网络依赖：即使离线也能正常工作\n- 零运营成本：没有 API 调用费用或云存储费用\n- 毫秒级响应：本地 SQLite 查询速度极快\n\n---\n\n使用场景与价值\n\nmy-local-storage-mcp 特别适合以下场景：\n\n个人知识管理\n开发者可以在与 AI 助手协作的过程中，将重要的技术决策、架构思路、代码模式等知识持久化存储。下次开启新对话时，AI 可以快速检索相关背景，提供更有针对性的建议。\n\n项目上下文保持\n在大型项目中，开发者往往需要与 AI 讨论复杂的业务逻辑和技术细节。通过 my-local-storage-mcp，这些上下文可以被结构化地保存，避免每次都要重新解释项目背景。\n\n团队知识沉淀\n虽然项目定位为个人工具，但其简单的 SQLite 文件格式也便于团队成员之间共享知识库。可以将数据库文件纳入版本控制，实现团队级别的知识积累。\n\n---\n\n安装与集成\n\n项目的安装非常简单，支持通过 npm 全局安装：\n\nbash\nnpm install -g git+https://github.com/avm-sistemas/my-local-storage-mcp.git\n\n\n安装后，可以在任何支持 MCP 协议的客户端（如 Cursor、Claude Desktop 等）中配置使用。服务器启动后会自动初始化数据库，无需手动创建表结构。\n\n---\n\n总结与思考\n\nmy-local-storage-mcp 展示了如何在保持架构简洁的同时解决实际问题。它没有追求花哨的向量检索或复杂的语义分析，而是巧妙地利用 LLM 自身的能力来生成元数据，用 SQLite 这种经过时间考验的技术来实现持久化存储。\n\n这种"足够好"的工程哲学值得借鉴：在很多场景下，我们不需要最先进的向量数据库或最复杂的 NLP 管道，一个设计良好的 SQLite 方案就能满足需求。对于希望为 AI 助手添加记忆能力、但又不想引入复杂基础设施的开发者来说，my-local-storage-mcp 是一个值得尝试的轻量级选择。