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 格式保存对话
  • 带有时间戳的对话时间分析
  • 支持阅读最近的日记条目
  • 日记条目按时间顺序组织

安装

依赖于您的 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 :初始提示

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