Journaling MCP

🚀 MCP 日志记录服务器

MCP 日志记录服务器专为处理交互式日志记录会话而设计，支持情感分析与自动对话保存，能有效提升日志管理效率。

🚀 快速开始

MCP 日志记录服务器可助力您高效管理日志记录会话，支持情感分析与自动保存对话。您可参考以下内容进行安装与使用。

✨ 主要特性

• 自动化日志管理：实现日志记录会话的自动化管理，减轻人工操作负担。
• Markdown 格式保存：对话以 Markdown 格式保存，方便查看与编辑。
• 时序分析：具备时间戳的对话时序分析，便于了解对话的时间顺序。
• 最近日志阅读：支持阅读最近的日志条目，快速获取最新信息。
• 日志条目组织：按时间顺序组织日志条目，使日志管理更加有序。

📦 安装指南

从您的 MCP 客户端，使用 Claude Desktop 进行依赖配置：

    "mcpServers": {
        "journaling": {
            "command": "uv",
            "args": [
                "--directory",
                <仓库路径>,
                "运行",
                "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("用户消息", "助手消息")

# 生成并保存会话摘要
generate_session_summary("会话摘要内容")

# 获取最近 5 条条目
recent_journals = get_recent_journals()

📄 API 文档

工具

• start_new_session()：启动新的日志记录会话
• record_interaction(user_message, assistant_message)：记录一次消息交换
• generate_session_summary(summary)：生成并保存会话摘要
• get_recent_journals()：获取最近 5 条条目

资源

• journals://recent：访问最近日志的端点

提示词

• start_journaling：初始提示