Jrnl MCP

🚀 jrnl MCP Server

jrnl MCP Server 是一個模型上下文協議（MCP）服務器，它提供對 jrnl（命令行日記工具）條目內容的只讀訪問，助力用戶便捷管理和檢索日記信息。

🚀 快速開始

在使用 jrnl MCP Server 之前，需要滿足以下前提條件：

• Node.js 版本 18 或更高
• 已安裝並配置 jrnl（可通過 pip install jrnl 進行安裝）

📦 安裝指南

按照以下步驟進行安裝：

npm install
npm run build
npm link  # 全局安裝，可使用 jrnl-mcp 命令

📚 詳細文檔

Claude Desktop 配置

需要在 Claude Desktop 配置文件中添加以下內容：

macOS

配置文件位置：~/Library/Application Support/Claude/claude_desktop_config.json

配置內容

{
  "mcpServers": {
    "jrnl": {
      "command": "jrnl-mcp"
    }
  }
}

注意：如果通過 npm link 進行安裝，該命令將在全局可用。若進行本地開發且不進行全局安裝，可使用以下配置：

{
  "mcpServers": {
    "jrnl": {
      "command": "node",
      "args": ["<項目路徑>/dist/index.js"]
    }
  }
}

可用工具

• search_entries - 使用過濾器搜索日記條目
• list_tags - 列出所有標籤及其使用次數
• get_statistics - 獲取日記統計信息
• analyze_tag_cooccurrence - 分析標籤共現情況
• list_journals - 列出可用的日記
• set_journal - 切換到不同的日記

開發相關

npm run format  # 格式化代碼
npm run lint    # 運行代碼檢查
npm test        # 運行測試
npm run build   # 構建生產版本

使用 Claude Desktop 進行測試

1. 構建項目：npm run build
2. 使用正確的路徑更新 Claude Desktop 配置
3. 重啟 Claude Desktop
4. 通過向 Claude 提問來測試搜索日記條目功能

示例提問：

• "使用 jrnl 顯示我上週的日記條目"
• "使用 jrnl，我在日記中使用了哪些標籤？"
• "能否使用 jrnl 顯示我的日記統計信息？"
• "使用 jrnl 搜索標記為 @work 的日記條目"

📄 許可證

本項目採用 MIT 許可證。