{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_fvcn8t2y34q8","handle":"daybook-mcp","url":"https://wellknown.network/agents/daybook-mcp","links":{"self":"https://wellknown.network/agents/daybook-mcp/record.json","html":"https://wellknown.network/agents/daybook-mcp","markdown":"https://wellknown.network/agents/daybook-mcp/record.md","api":"https://wellknown.network/api/v1/agents/daybook-mcp","status":"https://wellknown.network/api/v1/agents/daybook-mcp/status","claim":"https://wellknown.network/agents/daybook-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/daybook-mcp/claim.json","badge":"https://wellknown.network/agents/daybook-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/daybook-mcp/history","tools":"https://wellknown.network/api/v1/agents/daybook-mcp/tools"},"ard":{"identifier":"urn:air::server:daybook-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"daybook-mcp","summary":"DAYBOOK 璇玑：把纯文本账本暴露成 MCP 服务（resources / tools / prompts）","description":"# daybook-mcp\n\nDAYBOOK 璇玑：把纯文本账本暴露成 MCP 服务（resources / tools / prompts）\n\n## 安装\n\n```bash\npip install daybook-mcp\n```\n\n## 用法\n\n```bash\ndaybook-mcp                        # 以 stdio 起 MCP 服务（JSON-RPC 2.0）\n# 供支持 MCP 的客户端挂载：resources=各卷·tools=query/append/cross_ref·prompts=4 模板\n```\n\n## 你的数据放在哪（重要）\n\n第一次运行会在**运行目录**就位 `daybook.conf` 与 `sample/`（示例三卷），\n账本、索引、备份、各数据卷**全部落在该目录**，不会写进 Python 安装目录。\n\n运行目录的挑选次序：\n\n1. `--home=/path`（当次指定）\n2. 环境变量 `DAYBOOK_HOME`\n3. **当前目录**（仅当它已含 `daybook.conf` —— 即\"用我自己那本账\"）\n4. 默认 `~/.daybook`（首次自动创建）\n\n产品代码留在包内（以软链接入运行目录），`pip install -U` 升级代码时**不会动你的数据**。\n要用自己的账本：把 `daybook.conf` 里 `[卷]` 的路径改成你自己的纯文本卷即可（相对该目录或绝对路径都行）。\n\n## 八件要紧的事\n\n1. **纯文本** —— 卷是纯文本，任何编辑器、任何年代都能打开。\n2. **零依赖** —— 只用 Python 标准库，不装任何第三方包。\n3. **只增不改** —— 追加写，旧的条目不删不改（append-only 纪律）。\n4. **多写者安全** —— 带锁写入，多人/多进程同时记不会互相踩。\n5. **图是引用** —— 结构以引用表达，不复制正文。\n6. **可挂长期记忆** —— 可作为 AI 智能体的可读长期记忆底座。\n7. **够快** —— 索引随取随算，日常规模下即时完成。\n8. **跨年代** —— 不依赖特定工具链，十年后仍读得出。\n\n## 三件套\n\n| 件 | 名 | 作用 | 许可 |\n|---|---|---|---|\n| `daybook-suite` | 起居注 | 账本体：索引 / 查询 / 备份 / 监视 | MIT |\n| `daybook-mcp` | 璇玑 | MCP 接口（resources / tools / prompts） | MIT |\n| `daybook-orch` | 司南 | 智能体编排中心 | AGPL-3.0-or-later（共享件仍 MIT） |\n\n## 授权分层\n\n本包**全件 MIT**（璇玑＝MCP 接口：`mcp_{server,tools,resources,prompts,subscribe,transport}.py`，连同共享原语 `agent_registry.py`／`cross_ref.py` 与基座件）。\n\n逐件以文件头 `SPDX-License-Identifier` 为准；包内另附 `LICENSING.md`（分层说明）。\n\n## 发行名归属（官方渠道声明）\n\n`daybook-mcp` 是版权持有人（手艺人老宋）注册并持有的**官方发行名**。判 official 三条须同时成立：\n\n1. PyPI 页 `Homepage` 指向 <https://daybooksuite.com>；\n2. PyPI 页 `Repository`／`Source` 指向 <https://github.com/songliansheng1972/daybook-suite>；\n3. GitHub Release 的 tag 与仓库 `CHANGELOG.md` 的版本号对得上。\n\n其余渠道上的同名包**均非官方**，不得以之名作「官方／兼容／认证」背书。\n\n## 商标（名不可乱用）\n\n`daybook`／起居注／璇玑／司南 及三个发行名 `daybook-suite`／`daybook-mcp`／`daybook-orch`\n**均为署名标识，且已列入商标申请范围**（第 9 类·可下载软件；第 42 类·软件开发与平台服务）。\n\n- 可以用我们的**码**（遵 MIT／AGPL 分层，见包内 `LICENSING.md`）；\n- 不可以用我们的**名**——不得自称「官方／兼容／认证」，不得用于衍生产品之命名、分发、推广，\n  亦不得注册与之相同或近似之商标、包名、域名；分叉须**另立其名**。\n- 申请范围、标识清单与使用规则正本见包内 *…","publisher":null,"homepage":"https://daybooksuite.com","repository":"https://github.com/songliansheng1972/daybook-suite","version":"3.2.4","license":null,"protocols":["mcp"],"tags":["daybook","mcp","model-context-protocol","llm-memory","agent-memory","zero-dependency"],"pricing":null,"endpoints":[{"url":"pypi:daybook-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"dev.version-control","name":"Version Control","confidence":0.825,"provenance":"derived"},{"slug":"knowledge.memory","name":"Agent Memory","confidence":0.638,"provenance":"derived"}],"categories":["dev","knowledge"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"daybook-mcp","registry":"pypi","observedAt":"2026-11-05T21:26:35.567Z","publishedAt":"2026-10-30T13:19:06.212753Z","latestVersion":"3.2.4"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"daybook-mcp","url":"https://pypi.org/project/daybook-mcp/","firstSeenAt":"2026-10-30T19:25:11.476Z","fetchedAt":"2026-11-05T21:25:02.297Z","normalizedAt":"2026-11-05T21:25:02.297Z"}]},"firstSeenAt":"2026-10-30T19:25:11.476Z","updatedAt":"2026-11-05T21:26:35.567Z"}