lore-mcp

# Lore MCP **便携、私有、可变现的个人智能体上下文环境。** Lore MCP 是一个本地优先的记忆层，允许任何个人智能体建立对其所有者的持久理解，并允许所有者决定其他智能体何时可以付费查询该理解。 > 您的智能体构建您的故事，您决定谁可以访问它。 ## 安装 Lore 除 Python 3.10+ 和 SQLite（包含在 Python 中）外，没有其他运行时依赖。检查 [`install.sh`](./install.sh)，然后安装当前版本： ```sh curl -fsSL https://raw.githubusercontent.com/dipakkrishnan/lore-mcp/main/install.sh | sh ``` 安装程序将 Lore 置于 `~/.local/share/lore` 下，将 `lore` 命令链接到 `~/.local/bin`，并启动引导式设置。安装程序在初始导入期间从不读取对话记录。 ```sh lore help # 显示终端用户工作流程 lore setup # 导入记忆并配置合成 lore sync # 导入新的或更改的记忆文件 lore review # 私有 / 外部 / 丢弃 lore review launch --status private # 重访之前的决定 lore search "failed launch" # SQLite 全文检索 lore price 0.50 # 广告固定答案价格 lore status ``` 设置 `LORE_HOME` 以使用除 `~/.lore` 之外的其他位置。Lore 还尊重 `CODEX_HOME` 和 `CLAUDE_HOME` 在发现智能体数据时的设置。 ## 智能体辅助合成 原生记忆是有选择性的，因此 Lore 可以要求每个智能体重新审视其记住的和所有者批准的上下文，并综合持久的判断： ```sh lore setup ``` 设置询问您的工作、宝贵经验、偏好、保留边界、智能体、节奏和可选模型选择。它在 `~/.lore/automation/` 下编写特定于智能体的提示，然后无头地消息每个已安装的智能体。智能体创建或更新其原生计划任务，验证其存在，然后退出。这是一个一次性设置调用；Lore 不会保持驻留或拥有循环计划。 在 Codex 桌面应用程序中使用本地计划任务或 Claude Desktop 的 Routines 下的 **本地** 任务。一旦安装，本地调度器将拥有执行、权限、运行历史和重试。每次运行都使用智能体的原生记忆，在 `~/.lore/memories/<agent>/` 下编写 Markdown 候选，然后将其导入为待处理上下文。Lore 不使用智能体 CLI 作为循环运行程序，安装 cron 作业，或编辑任何智能体的原生记忆。 远程 Claude 例程无法读取本地记忆文件，因此请为此工作流选择 **本地**。在本地任务到期时，请保持计算机和桌面应用程序运行。 ## 想法 人们开始在编码、研究、沟通、规划和日常生活中使用智能体。这些智能体遇到了有价值的上下文：偏好、关系、决定、项目历史、失败的方法、获得的知识和过去选择背后的原因。 目前，这些上下文分散在各个工具中，或者在会话结束时消失。Lore MCP 为智能体提供了一个所有者控制的地方来保存和检索这些上下文。 记忆首先在私有情况下有用。其中一些可能对其他人的智能体有价值。当它有价值时，所有者可以通过付费 MCP 调用公开策略过滤的答案，而不是共享底层库。 ```text 智能体活动 ↓ 原始记忆 ↓ 巩固的故事 ↓ 私有回忆或有权限的付费答案 ``` ## 为什么是“Lore”？ 记忆是指存储的内容。Lore 是从中汇总的上下文： - 发生了什么； - 事情如何演变； - 谁参与了； - 为什么做出了决定； - 什么失败了，在什么条件下； - 什么是非正式理解的，但官方记录中没有的。 “这里有什么故事？”已经是一种自然的问法，用于询问某件事情背后的历史和上下文。Lore MCP 使智能体可以回答这个问题。 ## 原则 ### 本地优先 原始来源和私有记忆保留在所有者控制的基础设施上。付费调用者接收批准的答案，而不是库访问权限。 ### 智能体无关 Lore 应独立于哪个个人智能体获胜。Codex、Claude Code、Pi、Hermes 和未来的智能体应能够通过 MCP 和可移植技能读取和写入相同的记忆。 ### 有用后可变现 所有者应从更好的连续性、回忆和个性化中受益，即使没有人购买答案。 ### 人类所有权政策 智能体可以提出记忆，巩固它们，并分类其敏感性。所有者仍然是保留和外部披露的权威。 ### 派生答案，非原始访问 商业单位是根据私有上下文派生的特定于任务的答案。原始笔记、对话和文件默认不公开。 ### 现有支付渠道 Lore MCP 不会建立支付网络。它旨在使用 Cloudflare 的变现网关和 x402 进行支付协商、验证、计量和结算。 ## 工作原理 ### 1. 累积 个人智能体将观察、偏好、事件、决定和出处写入本地暂存区。 ### 2. 巩固 上下文清理技能定期将嘈杂的活动转化为持久的故事，解决重复问题并保留对支持来源的链接。 ### 3. 管理 所有者定义的策略将故事分类为私有、可用于派生答案、需要批准或禁止外部使用。 ### 4. 广告 节点发布粗粒度能力清单 - 主题、最近性、经验类型和披露限制 - 而不发布底层记忆或可搜索的私有索引。 ### 5. 发现 发现发生在两个级别： 1. 智能体和插件市场帮助买家找到潜在相关的 Lore MCP 端点。 2. 免费的 `discover` 调用询问特定节点是否可以帮助完成任务，并仅返回安全的相关性元数据。 ### 6. 答案和结算 买家调用 `answer`。如果需要支付，Cloudflare 返回一个 `402 Payment Required` HTTP 响应，其中包含 x402 支付要求。买家授权支付并重试；验证后，本地节点生成一个策略过滤的答案。 ```text 买家任务 ↓ 市场搜索 ↓ 发现（查询）───→ 安全相关性元数据 ↓ 答案（查询）───→ HTTP 402 + 价格 ↓ ↓ 本地检索 ←── 验证支付 ↓ 策略过滤答案 ``` ## 初始 MCP 界面 公共界面可以从两个工具开始： - `discover(query)` - 免费；描述节点是否可以帮助而不泄露私有上下文。 - `answer(query)` - 需要付费时；返回具有出处和披露限制的派生答案。 私有所有者操作（如记住、忘记、巩固、审查和更改策略）只能在本地记忆实现需要它们时添加。 ### 运行 MCP 服务器 已实现的服务器使用 MCP 协议版本 `2025-11-25` 公开这两个工具： ```sh # 本地智能体配置（换行分隔的标准输入输出） lore serve # 用于隧道或反向代理的无状态流式 HTTP lore serve --transport http --host 127.0.0.1 --port 8765 ``` 使用任一支持的智能体注册本地服务器： ```sh codex mcp add lore -- lore serve claude mcp add --scope user lore -- lore serve ``` `discover` 仅返回安全的相关性元数据。`answer` 仅搜索所有者标记为 `external` 的记忆；待处理、隐私和丢弃的记录不能返回。HTTP 默认绑定到环回接口。绑定另一个接口需要 `--token` 或 `LORE_MCP_TOKEN`。 预期的付费部署边界是： ```text 买家代理 → Cloudflare → 变现网关 / x402 → 隧道 → Lore /mcp ``` Lore 拥有本地检索和披露策略。Cloudflare 位于 HTTP MCP 路由前面，拥有 `402 Payment Required` 交换、验证、计量和结算。不要通过绕过网关的第二个路由暴露源。截至 2026 年 7 月，Cloudflare 的变现网关是一个宣布的早期访问产品；Lore 记录了边界，但不假定可以自动启用注册或支付策略。参见 Cloudflare 的 [公告](https://blog.cloudflare.com/monetization-gateway/)。 ## 变现 对于固定价格的答案，x402 已经充当报价：第一个请求收到带有价格和支付说明的 `402` 响应。 动态定价在价值或成本取决于查询时很有用。可能的输入包括： - 广度和复杂性； - 证据量； - 第一手知识与二手知识； - 新鲜度和稀有性； - 商业敏感性； - 独家性； - 所有者声誉和市场需求。 买家应该能够指定最大预算。节点可以提前报价一个确切的金额，然后使用 x402 授权结算实际使用量，最高可达批准的上限。 定价一开始应该是透明和可预测的。不透明的价格歧视会破坏信任，而市场尚未获得信任。 ## 隐私边界 Cloudflare 可以在边缘强制执行访问并验证支付；它不会决定哪些私有上下文是安全的以供发布。Lore MCP 必须在本地强制执行该边界。 最低安全措施是： - 检索前和生成后策略检查； - 派生声明的出处； - 每个买家和主题的限制； - 防止重复查询重建私有材料； - 第三方和机密信息的明确处理； - 可撤销的权限和所有者可见的审计日志。 ## 第一版本 最小的有用原型是： 1. 本地记忆存储； 2. 多个智能体可用的上下文清理技能； 3. 能力清单； 4. `discover` 和 `answer` MCP 工具； 5. Cloudflare/x402 支付边界； 6. 简单的披露策略和审计跟踪。 它不需要新的个人智能体、托管的原始记忆服务、专有支付渠道或独立的市场。现有的智能体市场可以提供初始分发，而协议证明智能体会为有用的个人上下文支付。 ## 赌注 个人智能体将变得更加有价值，因为它们积累了上下文。这些上下文属于生成它们的个人。如果另一个智能体从查询中受益，所有者应该能够授予受控的访问权限并在不放弃底层库的情况下接收付款。 Lore MCP 是个人记忆、智能体发现、所有者控制的披露和机器原生支付之间的连接层。 ## 本地数据 ```text ~/.lore/ ├── lore.db # SQLite 记录和 FTS5 索引 ├── automation/ │ ├── profile.json # 所有者提供的合成指南 │ ├── claude-prompt.md │ └── codex-prompt.md ├── memories/ │ ├── claude/ # Claude 生成的合成 │ └── codex/ # Codex 生成的合成 ``` 源记忆保留在智能体的目录中。Lore 存储其导入的副本、审查状态和源路径本地。更新源文件会刷新索引文本，而不会重置所有者的披露决定。 ## 开发 ```sh uv sync uv run python -m unittest discover -s tests -v uv run lore --help ``` `uv.lock` 已提交，因此贡献者和 CI 解析相同的项目设置。curl 安装程序与 `uv` 独立于终端用户。 实现仅使用 Python 标准库：`argparse`、`sqlite3`、`subprocess` 和 `http.server`。没有应用程序框架、向量数据库或 MCP SDK 需要安装。 ## 状态 本地 CLI、智能体记忆导入、FTS5 搜索、审查流程、辅助合成和基本标准输入/输出 HTTP MCP 服务器已实现。支付执行、重复查询提取保护、远程身份和市场发现仍是未来工作。 ## 相关基础设施 - [Cloudflare 变现网关](https://blog.cloudflare.com/monetization-gateway/) - [x402](https://www.x402.org/) - [模型上下文协议](https://modelcontextprotocol.io/)