MCP Journaling Server

by mtct

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • The server can be configured using environment variables in a .env file, allowing customization of journal directory, filename prefix, and file extension.

  • The server saves conversations in Markdown format, with journal entries stored as .md files that include formatted conversations with timestamps, emotional analysis, and reflections.

  • The server supports temporal analysis of conversations with timestamps, providing chronological organization of journal entries.

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

感情分析と自動会話保存をサポートするインタラクティブなジャーナリング セッションを処理するように設計された MCP (メッセージ制御プロトコル) サーバー。

特徴

  • 自動ジャーナリングセッション管理
  • Markdown形式での会話の保存
  • タイムスタンプによる会話の時間的分析
  • 最近のジャーナルエントリの読み取りをサポート
  • ジャーナルエントリの時系列構成

インストール

Claude Desktop の MCP クライアントに依存します。

"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 : 初期プロンプト

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

MCP サーバーは、Claude とのチャットをジャーナリング セッションに変換し、会話をローカルに保存して、LLM が以前のセッションを取得できるようにし、日常の活動に関する議論に継続性を生み出します。

  1. Features
    1. Installation
      1. Configuration
        1. File Structure
          1. Entry Format
            1. API
              1. Tools
              2. Resources
              3. Prompts
            ID: kiay3i2li7