VibeDNA Journal

VibeDNA Journal MCP

プロジェクトごとにジャーナルファイルを1つ作成し、AIがセッション開始時に読み込み、作業しながら更新します。

ジャーナルは、各プロジェクトにプレーンなMarkdownファイル（*_JOURNAL.md）を1つ用意します。AIはセッション開始時にそれを読み込み、作業を進めるなかで追記します。理由を添えた決定事項、根本原因と修正内容を記したバグ、現在の状況、ロードマップ、次のセッションへの引き継ぎメモなどを記録します。ランキング付き全文検索で、すべてのプロジェクトのジャーナルから一度にエントリーを見つけられます。オプションのツールを1つ使うと、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など、1つのセクション
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)	1種類のジャーナルをメタデータ付きで表示するローカルフィード
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に「ジャーナルのCLAUDE.mdルールをグローバルにインストールして」と頼んでください。この手順を行うと、ジャーナルを自動で読み書きするようになります。

Cursor

同じmcpServersブロックを、~/.cursor/mcp.json（すべてのプロジェクト）または.cursor/mcp.json（1つのプロジェクト）に追加します。

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 をご覧ください。Copyright (c) 2026 VibeDNA.

サポート：[email protected]