Claude Journal MCP

MCP数据服务

提供方 chrismbryant

数据服务 stdio · 本地进程 会话登录 社区 / 第三方 Claude
查看接入方式

一个基于SQLite的轻量级日志插件,提供快速本地存储、智能搜索和自动捕获功能,适用于开发者的日常工作和项目跟踪。

一句话选型结论

按资料字段整理

Claude Journal MCP 属于数据服务类 MCP 服务器,stdio · 本地进程,会话登录,可直接接入 Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类数据服务 传输方式stdio · 本地进程 鉴权会话登录 部署方式本地部署
GitHub 星标 5 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

数据服务
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

日志管理Python本地部署SQLite开发工具项目跟踪智能搜索

安装与配置

stdio · 本地进程 会话登录
客户端在本机拉起子进程,数据不出本机
pip install -e .

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js 等运行时,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
数据库查询

用自然语言查库、取数,不用手写 SQL。

数据同步与清洗

把多来源数据拉到一处做整理。

报表取数

按口径快速拉出统计结果。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好会话登录对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在数据服务场景里让模型直接调用外部能力的人。
  • 已经在用 Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Claude Journal MCP当前 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Memory 9d25f64e 9 未标注 未标注 无 2026-05-17
Getzep MCP 9 stdio · 本地进程 本地部署 有 2026-05-17
anything-llm 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Prisma MCP Server 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Astr Bot 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

数据服务
字段来自项目仓库与公开索引,中文说明由本站标注
提供方chrismbryant上游标注的维护方 chrismbryant
分类数据服务本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式会话登录远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

12.8 KB
来自项目仓库与上游目录的原文,未做删改

Claude Journal-克劳德代码插件

Claude Code的轻量级日志/内存系统,不依赖ML。使用简单的SQLite进行快速的本地存储。

这是一个功能齐全的Claude Code插件,具有斜线命令、技能、代理和自动捕获挂钩。

特性

  • ✅ 轻量级:没有嵌入,没有ML模型,只有SQLite
  • ✅ 快速:本地数据库上的亚毫秒级查询
  • ✅ 智能搜索:具有ID查找、标签过滤、精确短语、日期范围和关键字的高级搜索
  • ✅ 时间查询:自然语言,如“上个月”、“昨天”
  • ✅ 项目跟踪:按存储库/项目组织条目
  • ✅ 自动捕获:通过挂钩自动定期记录日志
  • ✅ 导入/导出:在实例之间共享日志
  • ✅ 灵活标签:使用自定义标签进行组织
  • ✅ 斜杠命令:6个用户友好的常用操作命令
  • ✅ 技能:3种主动的人工智能技能,用于上下文恢复和智能捕获
  • ✅ 代理:可选日记助理,可增强工作流程

需求

  • Python 3.12或更高版本
  • 紫外线 (推荐)或pip

安装

快速入门(推荐)

  1. 安装uv (如果尚未安装):```bash
    curl -LsSf https://astral.sh/uv/install.sh | sh

2. **克隆并安装插件:**```bash
git clone https://github.com/chrismbryant/claude-journal-mcp.git
cd claude-journal-mcp
uv sync
  1. 安装为Claude Code插件:```bash

Option A: Direct install from current directory

claude /plugin install .

Option B: Add marketplace first, then install

claude /marketplace add ./marketplace.json
claude /plugin install claude-journal


这会自动:

- 配置MCP服务器(提供所有11个日志工具)
- 注册6个斜线命令(/journal add、/journals search等)
- 实现3种主动技能(日志捕获、上下文恢复、查找相关工作)
- 设置自动捕获挂钩(每30分钟或3条消息触发一次)
- 提示您启用日志助理代理(选择加入)

### 替代方案:手动安装MCP服务器

如果您更喜欢只安装MCP服务器而不安装插件功能:

1. **安装依赖项:**```bash
# With uv (recommended - faster)
uv sync

# Or with pip
pip install -e .
  1. 增添 ~/.claude/config.json 或者你的项目 .mcp.json:```json
    {
    "mcpServers": {
    "journal": {
    "command": "python",
    "args": ["-m", "claude_journal.server"]
    }
    }
    }

**注:** 手动安装仅提供MCP工具。如果不作为插件安装,您将无法获得斜线命令、技能或代理。

## 数据库位置

违约: `~/.claude/journal.db`

用环境变量覆盖:```bash
export JOURNAL_DB_PATH="/path/to/your/journal.db"

斜杠命令

该插件提供了6个斜线命令,便于交互:

/journal-add

交互式创建新日记条目。Claude将指导您:

  • 标题
  • 描述
  • 项目(从git自动检测到)
  • 标签(根据内容建议)```
    You: /journal-add
    Claude: Let's create a journal entry. What's the title?
    You: Implemented rate limiting
    Claude: Great! Tell me more about it...

### `/journal-search`

使用高级查询语法搜索条目。支持ID查找、标签过滤、精确短语、日期范围和关键字。```
You: /journal-search
Claude: What would you like to search for?
You: authentication
Claude: [Shows all auth-related entries]

高级搜索语法:

  • ID搜索: 42 或 id:42 -按ID查找特定条目
  • 标签过滤器: tag:bugfix 或 #bugfix -按标签筛选
  • 精确短语: "user authentication" -匹配精确短语
  • 日期范围: last week authentication -将时间与搜索相结合
  • 组合的: tag:bugfix "login error" last month -混合多个过滤器

/journal-recent

显示最近的条目以还原上下文(在以下情况下特别有用 /clear).```
You: /clear
You: /journal-recent
Claude: Here's what you were working on:
[Lists recent entries with summaries]


### `/journal-time`

使用自然语言时间表达式查询条目。```
You: /journal-time
You: last week
Claude: [Shows all entries from last week]

支持:“昨天”、“上月”、“2024年1月”、“最近3天”等。

/journal-stats

查看有关日志使用情况的统计信息。```
You: /journal-stats
Claude:
📊 247 entries across 5 projects
📅 Jan 15 - Jul 20, 2024 (6 months)
Most active: my-app (89 entries)


### `/journal-export`

导出日志以在机器之间进行备份或共享。```
You: /journal-export
Claude: Where should I save the export?
You: ~/backups/journal_2024.db
Claude: ✅ Exported to ~/backups/journal_2024.db

技能

该插件包括Claude自动使用的3种主动技能:

journal-capture

当您执行以下操作时,自动捕获重要工作:

  • 完成功能或任务
  • 修复复杂错误
  • 做出技术决策
  • 解决具有挑战性的问题

克劳德能够识别重要时刻,并在未被询问的情况下捕捉到它们。

context-recovery

从日志中恢复您的工作环境:

  • 自动地 之后 /clear 命令
  • 当你问“我在做什么?”
  • 在会议开始时继续过去的工作

带回项目背景、最近的更改和下一步。

find-related-work

搜索与当前任务相关的过去工作:

  • 在实现类似功能之前
  • 在做出架构决策时
  • 故障排除期间
  • 当你明确询问过去的工作时

有助于避免重新设计解决方案并保持一致性。

代理

该插件包括 可选的 期刊助理代理人。

当你第一次使用日记功能时,Claude会提示:```
Would you like to enable the Journal Assistant agent?

The agent helps by:
- Automatically capturing significant work
- Recovering context after /clear
- Finding related past work
- Suggesting when to journal

Enable now?


代理人是 **选择进入** 但建议获得最佳体验。

## 可用的MCP工具

### 写入操作

**`journal_add`** -手动添加条目```
Add a journal entry:
- title: "Implemented auth system"
- description: "Built OAuth2 flow with JWT tokens"
- project: "my-app"
- tags: ["auth", "backend"]

journal_auto_capture -自动保存进度```
Automatically called by hooks or when Claude detects significant work


### 读取操作

**`journal_search`** -高级文本搜索```
Search examples:
- "authentication" - Keyword search
- "42" or "id:42" - Find entry by ID
- "tag:bugfix" or "#bugfix" - Filter by tag
- "\"user authentication\"" - Exact phrase match
- "last week authentication" - Date range + keyword
- "tag:bugfix \"login error\" performance" - Combined filters

journal_time_query -基于时间的搜索```
What did I work on last week?
What did I do in January?
When did I implement feature X?


支持的时间表达式:

- `today`, `yesterday`
- `last week`, `last month`, `last year`
- `last 3 days`, `last 2 weeks`
- `this week`, `this month`, `this year`
- `january`, `january 2024`
- `2024-01-15` (ISO日期)

**`journal_list_recent`** -最近的条目```
Show me the last 10 entries
Show recent work on project X

journal_list_projects -所有项目```
List all projects with entry counts


**`journal_stats`** -统计数据```
Show journal statistics

管理操作

journal_delete -按ID删除```
Delete entry 42


**`journal_delete_by_project`** -删除项目的所有内容```
Delete all entries for project "old-app"

journal_import -从文件导入```
Import from ~/other-machine/journal.db


**`journal_export`** -导出到文件```
Export to ~/backup/journal_2024.db

用法示例

手动日记```

You: Remember that we implemented rate limiting today

Claude: [Calls journal_add]
✅ Journal entry created (ID: 42)


### 基于时间的查询```
You: What did I work on last month?

Claude: [Calls journal_time_query with "last month"]
Shows all entries from last month
``````
You: When did I add the auth system?

Claude: [Calls journal_time_query with search for "auth"]
Shows entries matching "auth" with dates

上下文恢复```

You: /clear
You: What was I working on?

Claude: [Calls journal_list_recent]
Shows recent work to restore context


### 项目组织机构```
You: Show me everything I've done on my-app

Claude: [Calls journal_search with project filter]
Lists all my-app entries

机器之间共享

机器1:```
You: Export my journal

Claude: [Calls journal_export]
✅ Exported journal to journal_export_20241105.db


机器2:```
You: Import journal from ~/Downloads/journal_export_20241105.db

Claude: [Calls journal_import]
✅ Imported 150 new entries

自动抓钩

该插件包含一个自动捕获挂钩,安装后会自动运行。

它是如何工作的:

  • 监控对话活动
  • 每30分钟触发一次 或 发送3+条消息时(以先到者为准)
  • 通过CLI自动创建日记条目
  • 保持状态 ~/.claude/journal-capture-state.json
  • 插件安装时自动启用

配置:

钩子的定义见 hooks/hooks.json 并自动启用:```json
{
"hooks": {
"UserPromptSubmit": [
{
"matcher": "*",
"hooks": [
{
"type": "command",
"command": "node ${CLAUDE_PLUGIN_ROOT}/hooks/journal-auto-capture.js"
}
]
}
]
}
}


**行为:**

- 在每次用户提示提交时运行,并显示日志(`📊 Journal auto-capture hook running`)
- 低开销(检查时间戳和计数器)
- 当达到阈值(30分钟或3条以上消息)时,提示Claude分析会话
- **克劳德必须回应** -要么创建日记条目,要么解释为什么不捕获
- Claude回顾了对话,并创建了一个有意义的日记条目:
- 目标(我们试图做的事情)
- 成就(做了什么)
- 相关标签和项目信息
- Claude还可以根据对话上下文随时主动使用日记工具来记录重要工作

## CLI接口

该插件包括一个最小的CLI,提供有关可用MCP工具的信息:```bash
python -m claude_journal.cli
# Or: claude-journal

所有日志操作都是通过MCP服务器执行的,而不是通过CLI命令。自动捕获钩子触发Claude使用 journal_auto_capture MCP工具。

数据库模式```sql

CREATE TABLE journal_entries (
id INTEGER PRIMARY KEY AUTOINCREMENT,
created_at TEXT NOT NULL DEFAULT (datetime('now')),
project TEXT,
title TEXT NOT NULL,
description TEXT NOT NULL,
tags TEXT
);

CREATE INDEX idx_created_at ON journal_entries(created_at);
CREATE INDEX idx_project ON journal_entries(project);


## 发展

### 运行测试```bash
pytest tests/

促成变更

重要提示: 这 main 分支受到保护,需要拉取请求。```bash

Create a feature branch

git checkout -b your-feature-name

Make your changes and commit

git add .
git commit -m "Description of changes"

Push your branch

git push -u origin your-feature-name

Create a pull request

gh pr create --title "Your PR title" --body "Description"

After CI passes, merge the PR

gh pr merge --squash --delete-branch


**不要直接推到main** -所有更改都必须通过pull请求。

### 项目结构```
claude-journal-mcp/
├── .claude-plugin/
│   └── plugin.json         # Plugin manifest
├── agents/
│   └── journal-assistant.md # Journal assistant agent
├── commands/
│   ├── journal-add.md      # /journal-add command
│   ├── journal-export.md   # /journal-export command
│   ├── journal-recent.md   # /journal-recent command
│   ├── journal-search.md   # /journal-search command
│   ├── journal-stats.md    # /journal-stats command
│   └── journal-time.md     # /journal-time command
├── hooks/
│   ├── hooks.json          # Hook configuration
│   └── journal-auto-capture.js # Auto-capture hook
├── skills/
│   ├── journal-capture/
│   │   └── SKILL.md        # Proactive capture skill
│   ├── context-recovery/
│   │   └── SKILL.md        # Context recovery skill
│   └── find-related-work/
│       └── SKILL.md        # Related work finder skill
├── src/
│   └── claude_journal/
│       ├── __init__.py
│       ├── server.py       # MCP server
│       ├── database.py     # SQLite operations
│       └── time_parser.py  # Natural language time parsing
├── tests/
├── .mcp.json               # MCP server config
├── pyproject.toml
├── LICENSE
└── README.md

为什么不嵌入?

嵌入/语义搜索:

  • 优点:按意思查找,而不是精确的单词
  • 缺点:4GB以上的依赖关系,需要PyTorch/CUDA

这种方法(SQLite全文):

  • 优点:轻量级(~10MB),即时查询,无机器学习依赖
  • 缺点:必须使用类似的关键字来查找条目

权衡:对于期刊,精确的关键字匹配通常就足够了。比起抽象概念,你更能记住“auth”、“bug”、“部署”等粗略的术语。

许可证

麻省理工学院

贡献

欢迎拉取请求!请确保:

  • 测试通过
  • 代码遵循现有样式
  • 更新README以获取新功能

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Claude Journal MCP 怎么安装?

在客户端按下面的安装命令接入:pip install -e .。装完在客户端配置里引用同一个包或端点。

Claude Journal MCP 怎么在 Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Claude Journal MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Claude Journal MCP 需要 API Key 吗?

资料标注需要会话登录认证,使用前准备好对应凭据,并按最小权限配置。

Claude Journal MCP 支持哪些客户端?

资料标注支持 Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Claude Journal MCP 能提供哪些能力?

资料显示能力标签包括 日志管理、开发工具、Python、Claude。具体工具清单以官方文档为准。

Claude Journal MCP 需要什么运行环境?

属于本地进程,需要在本机装好运行环境。

Claude Journal MCP 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。