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：初始提示