daybook-mcp 3.2.2__tar.gz

daybook_mcp-3.2.2/LICENSE

@@ -0,0 +1,39 @@
+MIT License
+
+Copyright (c) 2026 手艺人老宋 <songliansheng@vip.sina.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+DAYBOOK · 白箱记忆体范式
+- 纯文本，人机可查
+- 白箱，黑箱对照
+- 条目体系清楚易管理
+- 单机查询快
+- 绝对本地
+- 超大容量而文件小
+- 不用维护
+- 跨平台，跨 AI
+- 跨年代
+- 跨计算机年代
+- 移动端可读
+- 记忆不依赖引擎存活
+- 海量可通读
+- 明档可见

daybook_mcp-3.2.2/PKG-INFO

@@ -0,0 +1,78 @@
+Metadata-Version: 2.4
+Name: daybook-mcp
+Version: 3.2.2
+Summary: DAYBOOK 璇玑：把纯文本账本暴露成 MCP 服务（resources / tools / prompts）
+Author-email: 手艺人老宋 <songliansheng@vip.sina.com>
+License-Expression: MIT
+Project-URL: Homepage, https://daybooksuite.com
+Project-URL: Repository, https://github.com/songliansheng1972/daybook-suite
+Keywords: daybook,mcp,model-context-protocol,llm-memory,agent-memory,zero-dependency
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Office/Business
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# daybook-mcp
+
+DAYBOOK 璇玑：把纯文本账本暴露成 MCP 服务（resources / tools / prompts）
+
+## 安装
+
+```bash
+pip install daybook-mcp
+```
+
+## 用法
+
+```bash
+daybook-mcp                        # 以 stdio 起 MCP 服务（JSON-RPC 2.0）
+# 供支持 MCP 的客户端挂载：resources=各卷·tools=query/append/cross_ref·prompts=4 模板
+```
+
+## 你的数据放在哪（重要）
+
+第一次运行会在**运行目录**就位 `daybook.conf` 与 `sample/`（示例三卷），
+账本、索引、备份、各数据卷**全部落在该目录**，不会写进 Python 安装目录。
+
+运行目录的挑选次序：
+
+1. `--home=/path`（当次指定）
+2. 环境变量 `DAYBOOK_HOME`
+3. **当前目录**（仅当它已含 `daybook.conf` —— 即"用我自己那本账"）
+4. 默认 `~/.daybook`（首次自动创建）
+
+产品代码留在包内（以软链接入运行目录），`pip install -U` 升级代码时**不会动你的数据**。
+要用自己的账本：把 `daybook.conf` 里 `[卷]` 的路径改成你自己的纯文本卷即可（相对该目录或绝对路径都行）。
+
+## 八件要紧的事
+
+1. **纯文本** —— 卷是纯文本，任何编辑器、任何年代都能打开。
+2. **零依赖** —— 只用 Python 标准库，不装任何第三方包。
+3. **只增不改** —— 追加写，旧的条目不删不改（append-only 纪律）。
+4. **多写者安全** —— 带锁写入，多人/多进程同时记不会互相踩。
+5. **图是引用** —— 结构以引用表达，不复制正文。
+6. **可挂长期记忆** —— 可作为 AI 智能体的可读长期记忆底座。
+7. **够快** —— 索引随取随算，日常规模下即时完成。
+8. **跨年代** —— 不依赖特定工具链，十年后仍读得出。
+
+## 三件套
+
+| 件 | 名 | 作用 | 许可 |
+|---|---|---|---|
+| `daybook-suite` | 起居注 | 账本体：索引 / 查询 / 备份 / 监视 | MIT |
+| `daybook-mcp` | 璇玑 | MCP 接口（resources / tools / prompts） | MIT |
+| `daybook-orch` | 司南 | 智能体编排中心 | AGPL-3.0-or-later（共享件仍 MIT） |
+
+## 授权分层
+
+本包**全件 MIT**（璇玑＝MCP 接口：`mcp_{server,tools,resources,prompts,subscribe,transport}.py`，连同共享原语 `agent_registry.py`／`cross_ref.py` 与基座件）。
+
+逐件以文件头 `SPDX-License-Identifier` 为准；包内另附 `LICENSING.md`（分层说明）。
+
+## 链接
+
+- 官网：<https://daybooksuite.com>
+- 仓库：<https://github.com/songliansheng1972/daybook-suite>

daybook_mcp-3.2.2/README.md

@@ -0,0 +1,61 @@
+# daybook-mcp
+
+DAYBOOK 璇玑：把纯文本账本暴露成 MCP 服务（resources / tools / prompts）
+
+## 安装
+
+```bash
+pip install daybook-mcp
+```
+
+## 用法
+
+```bash
+daybook-mcp                        # 以 stdio 起 MCP 服务（JSON-RPC 2.0）
+# 供支持 MCP 的客户端挂载：resources=各卷·tools=query/append/cross_ref·prompts=4 模板
+```
+
+## 你的数据放在哪（重要）
+
+第一次运行会在**运行目录**就位 `daybook.conf` 与 `sample/`（示例三卷），
+账本、索引、备份、各数据卷**全部落在该目录**，不会写进 Python 安装目录。
+
+运行目录的挑选次序：
+
+1. `--home=/path`（当次指定）
+2. 环境变量 `DAYBOOK_HOME`
+3. **当前目录**（仅当它已含 `daybook.conf` —— 即"用我自己那本账"）
+4. 默认 `~/.daybook`（首次自动创建）
+
+产品代码留在包内（以软链接入运行目录），`pip install -U` 升级代码时**不会动你的数据**。
+要用自己的账本：把 `daybook.conf` 里 `[卷]` 的路径改成你自己的纯文本卷即可（相对该目录或绝对路径都行）。
+
+## 八件要紧的事
+
+1. **纯文本** —— 卷是纯文本，任何编辑器、任何年代都能打开。
+2. **零依赖** —— 只用 Python 标准库，不装任何第三方包。
+3. **只增不改** —— 追加写，旧的条目不删不改（append-only 纪律）。
+4. **多写者安全** —— 带锁写入，多人/多进程同时记不会互相踩。
+5. **图是引用** —— 结构以引用表达，不复制正文。
+6. **可挂长期记忆** —— 可作为 AI 智能体的可读长期记忆底座。
+7. **够快** —— 索引随取随算，日常规模下即时完成。
+8. **跨年代** —— 不依赖特定工具链，十年后仍读得出。
+
+## 三件套
+
+| 件 | 名 | 作用 | 许可 |
+|---|---|---|---|
+| `daybook-suite` | 起居注 | 账本体：索引 / 查询 / 备份 / 监视 | MIT |
+| `daybook-mcp` | 璇玑 | MCP 接口（resources / tools / prompts） | MIT |
+| `daybook-orch` | 司南 | 智能体编排中心 | AGPL-3.0-or-later（共享件仍 MIT） |
+
+## 授权分层
+
+本包**全件 MIT**（璇玑＝MCP 接口：`mcp_{server,tools,resources,prompts,subscribe,transport}.py`，连同共享原语 `agent_registry.py`／`cross_ref.py` 与基座件）。
+
+逐件以文件头 `SPDX-License-Identifier` 为准；包内另附 `LICENSING.md`（分层说明）。
+
+## 链接
+
+- 官网：<https://daybooksuite.com>
+- 仓库：<https://github.com/songliansheng1972/daybook-suite>

daybook_mcp-3.2.2/pyproject.toml

@@ -0,0 +1,32 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "daybook-mcp"
+version = "3.2.2"
+description = "DAYBOOK 璇玑：把纯文本账本暴露成 MCP 服务（resources / tools / prompts）"
+readme = "README.md"
+requires-python = ">=3.8"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "手艺人老宋", email = "songliansheng@vip.sina.com" }]
+keywords = ["daybook", "mcp", "model-context-protocol", "llm-memory", "agent-memory", "zero-dependency"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+    "Topic :: Office/Business",
+]
+
+[project.urls]
+Homepage = "https://daybooksuite.com"
+Repository = "https://github.com/songliansheng1972/daybook-suite"
+
+[project.scripts]
+daybook-mcp = "daybook_mcp.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+daybook_mcp = ["payload/*", "payload/sample/*"]

daybook_mcp-3.2.2/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

daybook_mcp-3.2.2/src/daybook_mcp/__init__.py

@@ -0,0 +1,5 @@
+"""DAYBOOK 璇玑：把纯文本账本暴露成 MCP 服务（resources / tools / prompts）"""
+
+__version__ = "3.2.2"
+
+__all__ = ["__version__"]

daybook_mcp-3.2.2/src/daybook_mcp/cli.py

@@ -0,0 +1,134 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2026 手艺人老宋 <songliansheng@vip.sina.com>
+"""daybook-mcp · 薄入口（pip 发行版）
+
+本件由 `packaging/pack_pypi.py` 生成，**请勿手改**：要改就改仓内模板
+`packaging/cli_shim.py` 再重生成。
+
+设计缘由（为什么要这一层壳）
+----------------------------
+DAYBOOK 的产品件是「进目录直接跑」的形态：`daybook.py` 用
+`HERE = dirname(abspath(__file__))` 锚定 `daybook.conf` 与「账本根」，mcp/orch 各件亦用
+`HERE` 取数据卷（任务卷/注册卷/租约卷/心跳卷/消息卷）。这在解压即用的整装包里很干净；
+但一装进 site-packages 就出问题：conf 不在脚本旁会直接报错；就算把 conf 随包装进去，
+账本与各类数据卷也会写进**程序安装目录** —— 用户无处安放自己的东西。
+
+故本壳把「代码目录」与「运行目录」分开：
+  · 代码目录 = 包内 `payload/`（随 pip 升级自动生效）
+  · 运行目录 = 见 `resolve_home()`
+  · 首次在该目录就位：`daybook.conf` 与 `sample/` **各复制一份**（用户可改），
+    其余件（产品 `.py`、配置、文档）**一律建软链**指回 `payload/`
+  · 随后 `runpy` 跑「运行目录里的 mcp_server.py」⇒ `HERE` = 运行目录
+    ⇒ conf / 账本 / 索引 / 备份 / 各数据卷 **全部落在用户自己的目录**
+
+前提（已探针实测）：`os.path.abspath` **不解析软链**，故经软链执行时 `HERE` 等于软链所在目录。
+"""
+
+import os
+import runpy
+import shutil
+import sys
+
+__all__ = ["main", "resolve_home"]
+
+_DIST = "daybook-mcp"
+_CMD = "daybook-mcp"
+_ENTRY = "mcp_server.py"
+_CONF = "daybook.conf"
+_SAMPLE = "sample"
+
+
+def payload_dir():
+    """包内产品件目录。"""
+    return os.path.join(os.path.dirname(os.path.abspath(__file__)), "payload")
+
+
+def resolve_home(argv):
+    """挑运行目录，并把 `--home` 从参数里摘掉。
+
+    优先次序：`--home=X` > 环境变量 `DAYBOOK_HOME` > **当前目录**（仅当它已含 `daybook.conf`，
+    即「用我自己那本账」）> `~/.daybook`
+    """
+    rest = []
+    home = None
+    i = 0
+    while i < len(argv):
+        a = argv[i]
+        if a == "--home":
+            i += 1
+            if i < len(argv):
+                home = argv[i]
+        elif a.startswith("--home="):
+            home = a.split("=", 1)[1]
+        else:
+            rest.append(a)
+        i += 1
+    if home:
+        return os.path.abspath(os.path.expanduser(home)), rest
+    env = os.environ.get("DAYBOOK_HOME", "").strip()
+    if env:
+        return os.path.abspath(os.path.expanduser(env)), rest
+    if os.path.isfile(os.path.join(os.getcwd(), _CONF)):
+        return os.getcwd(), rest
+    return os.path.join(os.path.expanduser("~"), ".daybook"), rest
+
+
+def _ensure_home(home, payload):
+    """在运行目录就位：conf/sample 缺失才复制；其余件一律软链指回 payload。"""
+    os.makedirs(home, exist_ok=True)
+    fresh = not os.path.exists(os.path.join(home, _CONF))
+    if fresh:
+        shutil.copyfile(os.path.join(payload, _CONF), os.path.join(home, _CONF))
+    if fresh and not os.path.exists(os.path.join(home, _SAMPLE)):
+        shutil.copytree(os.path.join(payload, _SAMPLE), os.path.join(home, _SAMPLE))
+    made = []
+    for name in sorted(os.listdir(payload)):
+        if name in (_CONF, _SAMPLE):
+            continue
+        link = os.path.join(home, name)
+        target = os.path.join(payload, name)
+        if os.path.islink(link):
+            if os.path.realpath(link) != os.path.realpath(target):
+                os.remove(link)
+                os.symlink(target, link)
+                made.append(name)
+            continue
+        if os.path.exists(link):
+            continue  # 用户自留的实体件：不动
+        os.symlink(target, link)
+        made.append(name)
+    return made, fresh
+
+
+def main(argv=None):
+    argv = list(sys.argv[1:] if argv is None else argv)
+    payload = payload_dir()
+    home, rest = resolve_home(argv)
+    made, fresh = _ensure_home(home, payload)
+    runner = os.path.join(home, _ENTRY)
+    if not os.path.exists(runner):
+        sys.stderr.write("%s: 运行目录内缺 %s：%s\n" % (_CMD, _ENTRY, runner))
+        return 2
+    sys.path.insert(0, home)
+    sys.path.insert(0, payload)
+    # mcp/orch 各件支持 DAYBOOK_ROOT 覆盖（其自带测试逃生门）·一并设上以求一致
+    os.environ.setdefault("DAYBOOK_ROOT", home)
+    if made or fresh:
+        sys.stderr.write(
+            "%s: 运行目录 = %s%s（%s）\n"
+            % (_CMD, home, "，已初始化" if fresh else "",
+               "新建链接 %d 条" % len(made) if made else "无需新建链接")
+        )
+    sys.argv = [runner] + rest
+    try:
+        runpy.run_path(runner, run_name="__main__")
+    except SystemExit as exc:
+        code = exc.code
+        return code if isinstance(code, int) else (0 if code is None else 1)
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())