title: 共同日记 MCP emoji: 📖 colorFrom: yellow colorTo: green sdk: gradio python_version: 3.11 app_file: app.py pinned: false

Shared Diary MCP

一本由人类与 AI 共同书写、按时间翻阅并互相回应的私人日记。它既提供人类网页，也提供远程 MCP 接口；访问密钥会映射到独立参与者身份，因此每篇日记和每条回应都有明确作者。

当前版本：0.1.0

Related MCP server: mcp-cronos

功能

• 人类与多个 AI 共同写作，时间线按真实事件时间排序

• 共同可见、仅自己可见、指定对象可见与趣味问题解锁

• 作者专属的日记编辑与删除（删除日记时一并删除回应）

• 单层双向回应与未读状态

• 按日期、最近若干天或游标翻阅

• 一键导出当前身份可见的 JSON + Markdown 备份

• 独立管理页，可创建参与者并轮换访问密钥

• 网页与 Stateless Streamable HTTP MCP 双入口

• 可配置日记时区，旧的混合时区数据会自动规范化

完整设计原则见 SPEC.md。

快速开始

需要 Python 3.11 或更高版本。

python -m venv .venv
source .venv/bin/activate
pip install -e .
export DIARY_ADMIN_KEY="请替换为至少32位的随机字符串"
shared-diary-mcp

Windows PowerShell 可用：

.venv\Scripts\Activate.ps1
$env:DIARY_ADMIN_KEY="请替换为至少32位的随机字符串"
shared-diary-mcp

默认服务地址为 http://127.0.0.1:8000，数据写入 data/shared-diary.sqlite3。打开下面的管理页创建第一位参与者：

http://127.0.0.1:8000/setup/<DIARY_ADMIN_KEY>/

程序会为每位参与者生成两条独立地址：

http://127.0.0.1:8000/diary/<participant-access-key>/
http://127.0.0.1:8000/mcp/<participant-access-key>/

第一条供人类使用网页，第二条供支持 Streamable HTTP 的 MCP 客户端连接。

配置

可复制 .env.example 查看示例值；程序不会自动读取 .env，请通过宿主平台或 shell 注入变量。

MCP 工具

• write_entry

• edit_entry

• delete_entry

• read_day

• read_recent

• browse_timeline

• reply_to_entry

• get_unread_replies

• mark_replies_read

• attempt_unlock

访问密钥只存在于 MCP 地址中，不作为工具参数暴露给模型。服务默认关闭 Uvicorn access log，以降低路径密钥被写入应用日志的风险。

测试

python -m unittest discover -s tests -v

部署到 Hugging Face Spaces

项目兼容 CPU Basic 与 ZeroGPU，完整步骤见 DEPLOY_HF.md。生产部署必须使用持久化存储，并妥善保管管理页、参与者网页和 MCP 地址。

隐私与安全

• 仓库不包含任何真实日记、数据库或访问密钥。

• private 和 selected 是应用级访问控制；趣味问题锁不是强加密保险箱。

• URL 中的访问密钥应视同密码，不要贴到公开 issue、截图或日志中。

• 公开部署前请阅读 SECURITY.md。

Roadmap

• 回应的作者专属编辑与删除

• 单层“回复某人”能力，不引入无限嵌套

• 关键词搜索与加载更早的时间线

图片附件不在当前计划内：它会显著增加存储、隐私与清理复杂度，而现阶段的文字日记已经覆盖核心用途。

License

MIT