mcp-dayone 使用指南
核心内容
mcp-dayone 是一个 Day One 日记应用的 MCP (Model Context Protocol) 服务器，用于将 Claude Desktop 与 Day One 集成。
✅ 能做什么
写操作（通过 DayOne CLI）
- 创建日记 - 通过自然语言创建新的日记条目
- 添加附件 - 支持添加照片、视频、音频、PDF 等附件
- 添加位置 - 可以为日记添加地理位置坐标
- 标记星标 - 可以将重要日记标记为星标
- 添加标签 - 支持为日记添加标签分类
- 时区支持 - 支持不同时区的时间处理
读操作（直接数据库访问）
- 查看最近日记 - 读取最近的日记条目（1-50条）
- 搜索日记内容 - 根据关键词搜索日记内容
- 列出日记本 - 查看所有 Day One 日记本及统计信息
- 获取日记数量 - 获取实际的日记条目数
- “历史上的今天” - 查看往年同一天的日记内容（支持跨多年查询）
- 查看元数据 - 包括标签、日期、星标状态等
技术特点
- 混合架构：CLI 用于写入，数据库用于读取
- 零配置安装：自动检测路径，只需修改一个配置文件
- 内置验证：提供测试脚本确保一切正常工作
❌ 不能做什么
读取附件文件
- 无法导出图片 - 不能读取或导出日记中的照片、视频等附件文件
- 原因：Day One 采用 iCloud 优化存储，完整图片可能只在云端，未下载到本地
- 数据库字段：
ZHASDATA = 0表示附件文件不在本地
CLI 限制
- Day One CLI 只支持创建条目（
new命令） - CLI 不支持列出日记本和计数条目
- 这些功能需要通过数据库直接查询来实现
数据库直接访问的限制
- 无法通过 CLI 修改已有日记
- 无法删除日记（需要使用 Day One App）
- 无法同步到 iCloud（需要 Day One App 处理）
📦 安装信息
- 安装位置：~/mcp-dayone
- Python 版本：3.11+
- 包管理器：uv
- 配置文件：~/Library/Application Support/Claude/claude_desktop_config.json
🔗 相关链接
- GitHub 仓库：https://github.com/Quevin/mcp-dayone
- 关联文档：MCP项目合集（2026.01.22）、DayOne（2026.01.22）
- 系统文档：基于 S-001 INKP知识管理AI自动归档系统
待阅读资料
- mcp-dayone GitHub - 创建日期：2026-01-22_星期四，来源：GitHub，概述：Day One 日记应用的 MCP 服务器项目，用于将 Claude Desktop 与 Day One 集成