MCP Journaling Server

MCP Journaling Server

site icon
2025.02.04 4
Python日志记录情感分析内容生成
MCP Journaling Server 是一个基于消息控制协议(MCP)的服务器,专为处理交互式日志记录会话而设计。它支持情感分析和自动对话保存,能够管理日志会话、保存Markdown格式的对话内容,并对对话进行时间戳分析。此外,它还支持读取最近的日志条目,并按时间顺序组织日志条目。
View on GitHub

Overview

基本能力

产品定位

MCP Journaling Server 是一个专为交互式日志记录设计的服务器,支持情感分析和自动对话保存。

核心功能

  • 自动日志会话管理
  • 以Markdown格式保存对话
  • 带时间戳的对话时间分析
  • 支持读取最近的日志条目
  • 按时间顺序组织日志条目

适用场景

  • 个人日志记录
  • 情感分析
  • 对话历史管理

工具列表

  • start_new_session(): 开始一个新的日志会话
  • record_interaction(user_message, assistant_message): 记录消息交换
  • generate_session_summary(summary): 生成并保存会话摘要
  • get_recent_journals(): 检索最近的5个日志条目

常见问题解答

  • 日志文件默认保存在 ~/Documents/journal 目录下
  • 文件名前缀默认为 "journal"
  • 日志文件扩展名默认为 ".md"

使用教程

使用依赖

依赖MCP客户端,如Claude Desktop。

安装教程

在Claude Desktop中配置:

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

调试方式

可以通过配置 .env 文件中的环境变量来调试服务器: - JOURNAL_DIR: 日志文件保存目录(默认:~/Documents/journal) - FILENAME_PREFIX: 文件名前缀(默认:"journal") - FILE_EXTENSION: 日志文件扩展名(默认:".md")

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。