🚀 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 许可证。
