私人日记MCP服务器

一个全面的MCP（模型上下文协议）服务器，提供给Claude私人日记记录和语义搜索能力，用于处理思想、情感和见解。

功能

日记记录

• 多部分日记记录：情感、项目笔记、用户上下文、技术见解和世界知识的不同类别
• 双重存储：项目笔记与项目一起保存，个人想法保存在用户的主目录中
• 时间戳条目：每个条目自动带有微秒精度的时间戳
• YAML元数据：每个条目的结构化元数据

搜索与发现

• 语义搜索：使用本地AI嵌入进行自然语言查询
• 向量相似性：查找概念上相关的条目，而不仅仅是关键词匹配
• 本地AI处理：使用@xenova/transformers，无需外部API调用
• 自动索引：启动时为所有条目生成嵌入，并持续更新

隐私与性能

• 完全私密：所有处理都在本地进行，没有数据离开您的机器
• 快速操作：优化的文件结构和内存中的相似度计算
• 强大的回退机制：跨平台智能路径解析

安装

此服务器直接从GitHub使用npx运行，无需安装。

MCP配置

Claude代码（一行）

claude mcp add-json private-journal '{"type":"stdio","command":"npx","args":["github:obra/private-journal-mcp"]}' -s user

手动配置

添加到您的MCP设置（例如，Claude桌面配置）：

{
  "mcpServers": {
    "private-journal": {
      "command": "npx",
      "args": ["github:obra/private-journal-mcp"]
    }
  }
}

服务器会自动找到适合的日记文件位置。

MCP工具

服务器提供了全面的日记记录和搜索功能：

process_thoughts

多部分私人日记记录，这些可选类别包括：

• feelings：私人情感处理空间
• project_notes：特定于当前项目的见解
• user_context：关于与人类协作的笔记
• technical_insights：通用软件工程学习
• world_knowledge：领域知识和有趣的发现

search_journal

在所有日记条目中进行语义搜索：

• query（必需）：自然语言搜索查询
• limit：最大结果数（默认：110）
• type：搜索范围 - 'project'，'user' 或 'both'（默认：'both'）
• sections：按特定类别筛选

read_journal_entry

读取特定条目的完整内容：

• path（必需）：来自搜索结果的文件路径

list_recent_entries

按时间顺序浏览最近的条目：

• limit：最大条目数（默认：10）
• type：条目范围 - 'project'，'user' 或 'both'（默认：'both'）
• days：搜索过去的天数（默认：30）

文件结构

项目日记（每个项目）

.private-journal/
├── 2025-05-31/
│   ├── 14-30-45-123456.md          # 项目笔记条目
│   ├── 14-30-45-123456.embedding   # 搜索索引
│   └── ...

用户日记（全局）

~/.private-journal/
├── 2025-05-31/
│   ├── 14-32-15-789012.md          # 个人想法条目
│   ├── 14-32-15-789012.embedding   # 搜索索引
│   └── ...

条目格式

每个Markdown文件包含YAML元数据和结构化的部分：

---
title: "下午2:30:45 - 2025年5月31日"
date: 2025-05-31T14:30:45.123Z
timestamp: 1717160645123
---

## 情感

我对这个新的搜索功能感到兴奋...

## 技术见解

向量嵌入提供了语义理解...

开发

构建

npm run build

测试

npm test

开发模式

npm run dev

提升Claude的表现

为了帮助Claude学习并随着时间的推移改进，请考虑在您的~/.claude/CLAUDE.md文件中添加日记使用指南：

## 学习和记忆管理

- 您必须频繁使用日记工具来捕捉技术见解、失败的方法和用户偏好
- 在开始复杂任务之前，在日记中搜索相关过去的经验和教训
- 记录架构决策及其结果以供未来参考
- 跟踪用户反馈中的模式，以提高长期合作
- 当您注意到需要修复但与当前任务无关的问题时，请将其记录在日记中而不是立即修复

这使Claude能够构建跨越对话的持久记忆，从而做出更好的工程决策和合作模式。

作者

Jesse Vincent jesse@fsck.com

更多关于动机和设计的信息，请参阅博客文章。

许可证

MIT