VibeDNA Journal

VibeDNA Journal MCP

每个项目对应一个日志文件，AI 会在会话开始时读取，并在工作过程中更新。

Journal 为每个项目提供一个纯 Markdown 文件（*_JOURNAL.md）。AI 会在会话开始时读取该文件，并随着工作推进将内容追加到其中：记录决策及其原因、Bug 的根本原因和修复方式、当前状态、路线图，以及供下次会话交接的备注。排序后的全文搜索可以一次性查找所有项目日志中的条目。一个可选工具会在你的 CLAUDE.md 中添加一条规则，让 Claude Code 持续养成这个习惯，无需你提醒。

• 通过 stdio 在本地运行。需要 Python 3.10+ 和 mcp 包。
• 日志核心不会进行网络调用。你的日志会保留在本地磁盘上。
• 仅当你调用可选的市场工具时，它们才会从 vibedna.ai 浏览并下载日志。

主页：https://vibedna.ai/store/journal

工具（25）

了解项目最新情况

工具	功能
journal_handoff_brief(name)	简要了解项目：标题及最新条目
journal_read(name, max_kb)	完整日志内容
journal_read_section(name, section)	读取一个章节，例如 Current state 或 Handoff for next session
journal_list_sections(name)	列出日志的 H2 章节
journal_list(project, last_days)	列出索引中的日志

记录已完成的工作

工具	功能
journal_append(name, entry, tag)	追加带时间戳的条目
journal_update_section(name, section, new_content, mode)	替换、追加或前置内容到一个章节
journal_create(name, project_dir, body)	创建包含标准章节的新日志

搜索

工具	功能
journal_search(query, project)	使用 SQLite FTS5 对所有日志进行排序后的全文搜索，并显示摘要片段
journal_recent_changes(last_hours)	查看最近更新的日志
journal_stats()	查看日志总数、最大及最新日志
journal_browse(domain, tier, kind, tag)	按元数据浏览本地库
journal_market_index(kind)	查看某类日志的本地动态列表及其元数据
journal_overlap_check(name)	查找与此日志内容重叠的其他日志

设置

工具	功能
journal_index_refresh()	重新扫描根目录，查找日志文件
journal_config_add_root(path)	添加要扫描的文件夹
journal_get_claude_rule()	获取推荐的 CLAUDE.md 规则文本
journal_install_rule(scope, confirm)	安装该规则（除非 confirm=True，否则仅预览）
journal_backup_to_drive(name, remote, remote_folder)	将日志复制到你自己的 rclone 远程存储（可选）
check_for_update()	将当前副本与已发布版本进行比较
vibedna_info()	产品元数据

市场（可选，会连接 vibedna.ai）

工具	功能
journal_market(query, domain)	浏览 VibeDNA 日志库
journal_pair(token)	将此安装关联到 vibedna.ai 账户
journal_get(slug)	下载你拥有的日志；若不拥有，则获取购买链接
journal_library()	列出你拥有的日志

安装

git clone https://github.com/marstudio360/vibedna-journal-mcp
cd vibedna-journal-mcp
pip install -r requirements.txt

JOURNAL_ROOTS 是要扫描日志文件的文件夹列表，文件夹之间以 ; 分隔。如果未设置，Journal 会扫描 ~/Desktop 和 ~/Documents。

Claude Code

claude mcp add journal --scope user -e JOURNAL_ROOTS="/path/to/your/projects" -- python /absolute/path/to/vibedna-journal-mcp/server.py

或者，添加到项目的 .mcp.json 中：

{
  "mcpServers": {
    "journal": {
      "command": "python",
      "args": ["/absolute/path/to/vibedna-journal-mcp/server.py"],
      "env": { "JOURNAL_ROOTS": "/path/to/your/projects" }
    }
  }
}

然后询问 Claude：“全局安装 journal 的 CLAUDE.md 规则。”这一步会让它自动读写日志。

Cursor

将相同的 mcpServers 配置块添加到 ~/.cursor/mcp.json（所有项目）或 .cursor/mcp.json（单个项目）。

Claude Desktop

将相同的 mcpServers 配置块添加到 claude_desktop_config.json（Settings > Developer > Edit Config），然后重启 Claude Desktop。

INSTALL.md 是一份分步指南，你可以将其粘贴到 AI 聊天中，让 AI 帮你完成安装。

配置

变量	默认值	用途
JOURNAL_ROOTS	~/Desktop;~/Documents	扫描包含 *JOURNAL*.md 文件的文件夹
JOURNAL_HOME	~/.journal	搜索索引和可选配置的存放位置
JOURNAL_TRANSPORT	stdio	http 会在 PORT 上提供可流式传输的 HTTP 服务，仅用于云托管

日志模板

journal_create 会为每篇日志添加以下章节：

## Vision / Why this exists
## Current state
## Roadmap
## Decisions log
## Incidents
## Handoff for next session
## Recent entries

安全

请参阅 SECURITY.md，了解服务会读取、写入和发送哪些内容。

许可证

MIT，详见 LICENSE。版权所有 (c) 2026 VibeDNA。

支持：[email protected]