MCP Journaling Server

MCP ジャーナリングサーバー

感情分析と会話の自動保存に対応した、対話型のジャーナリングセッションを扱うために設計されたMCP（Message Control Protocol）サーバーです。

機能

• ジャーナリングセッションの自動管理
• 会話をMarkdown形式で保存
• タイムスタンプ付きの会話の時系列分析
• 最近のジャーナルエントリの読み取りに対応
• ジャーナルエントリの時系列整理

インストール

MCP クライアントによって異なります。Claude Desktop の場合：

    "mcpServers": {
        "journaling": {
            "command": "uv",
            "args": [
                "--directory",
                <REPOSITORY PATH>,
                "run",
                "server.py"
            ]
        }
    }

設定

サーバーは、.env ファイル内の環境変数を使って設定できます。

• JOURNAL_DIR：ジャーナルファイルを保存するディレクトリ（デフォルト：~/Documents/journal）
• FILENAME_PREFIX：ファイル名のプレフィックス（デフォルト："journal"）
• FILE_EXTENSION：ジャーナルファイルの拡張子（デフォルト：".md"）

指定しない場合は、デフォルト値が使用されます。

ファイル構成

ジャーナルエントリは次の構成で保存されます。

[JOURNAL_DIR]/
├── journal_2025-01-27.md
├── journal_2025-01-26.md
└── ...

エントリ形式

各ジャーナルエントリには、次の内容が含まれます。

1. 日付を含むヘッダー
2. タイムスタンプ付きの会話記録
3. 感情分析
4. 振り返りと繰り返し現れるテーマ

API

ツール

• start_new_session()：新しいジャーナリングセッションを開始
• record_interaction(user_message, assistant_message)：メッセージのやり取りを記録
• generate_session_summary(summary)：セッションの要約を生成して保存
• get_recent_journals()：最新の5件のエントリを取得

リソース

• journals://recent：最近のジャーナルエントリにアクセスするエンドポイント

プロンプト

• start_journaling：初期プロンプト