JinDaGe - jrnl-mcp MCP Details

article

README

🚀 jrnl MCP Server

jrnl MCP Server 是一个模型上下文协议（MCP）服务器，它能提供对 jrnl（命令行日记工具）条目的只读访问，方便用户管理和查询日记信息。

🚀 快速开始

前提条件

Node.js 18 或更高版本
已安装并配置 jrnl（pip install jrnl）

安装步骤

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

Claude 桌面端配置

将以下内容添加到你的 Claude 桌面端配置文件中：

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：切换到不同的日记

💻 使用示例

基础用法

# 搜索上周的日记条目
# 前提：已在 Claude 中正确配置 jrnl MCP Server
"Use jrnl to show me my journal entries from last week"

# 列出日记中使用的标签
"Using jrnl, what tags am I using in my journal?"

# 获取日记统计信息
"Can you use jrnl to show me statistics about my journal?"

# 搜索带有 @work 标签的日记条目
"Search my journal entries for entries tagged with @work using jrnl"

🔧 开发相关

开发命令

npm run format  # 格式化代码
npm run lint    # 运行代码检查
npm test        # 运行测试
npm run build   # 构建生产版本

使用 Claude 桌面端进行测试

构建项目：npm run build
使用正确的路径更新你的 Claude 桌面端配置
重启 Claude 桌面端
通过向 Claude 询问来测试搜索日记条目功能

示例提示语：

"Use jrnl to show me my journal entries from last week"
"Using jrnl, what tags am I using in my journal?"
"Can you use jrnl to show me statistics about my journal?"
"Search my journal entries for entries tagged with @work using jrnl"

📄 许可证

本项目采用 MIT 许可证。

jrnl-mcp