JinDaGe - obsidian-diary-mcp MCP Details

article

README

🚀 Obsidian Diary MCP Server

Obsidian Diary MCP Server是一款由AI驱动的日记应用，支持本地处理、自动反向链接和智能提示功能，能有效帮助用户记录和整理日记内容。

✨ 主要特性

AI生成反思提示：基于过去3个日历日生成反思提示。
日期引用与反向链接：自动生成 [[YYYY-MM-DD]] 格式的日期反向链接。
头脑风暴优先级排序：分析用户的写作内容（而非提示），进行优先级排序。
智能标签提取：利用主题相似度提取智能 #标签。
待办事项提取：将日记中的待办事项提取到组织化的清单中。
记忆轨迹分析：分析主题演变的记忆轨迹。
周日总结：提供每周反思提示。

📦 安装指南

1. 克隆并安装

git clone https://github.com/madebygps/obsidian-diary-mcp.git

cd obsidian-diary-mcp

uv sync

chmod +x start-server.sh

2. 配置

cp .env.example .env

编辑 .env 文件，设置 DIARY_PATH 和 PLANNER_PATH（必需）。

3. 添加到MCP客户端配置（例如GitHub Copilot CLI）

名称：diary
命令：/full/path/to/obsidian-diary-mcp/start-server.sh

配置文件（.env）说明

必需配置：DIARY_PATH、PLANNER_PATH
可选配置：
- OLLAMA_MODEL（默认：llama3.1:latest）
- OLLAMA_TIMEOUT（60s）
- OLLAMA_TEMPERATURE（0.7）
- OLLAMA_NUM_PREDICT（1000 tokens）

💻 使用示例

基础用法

创建：输入 "create a memory log for today"，AI将根据过去3天生成提示。
写作：在Obsidian中打开日记，在“Brain Dump”部分自由写作。
提取：输入 "extract todos from today's entry"，将行动项提取到计划器中。
链接：输入 "link today's memory log"，自动生成 [[YYYY-MM-DD]] 和 #标签。
探索：使用Obsidian的反向链接面板和图形视图。

高级用法

还支持更多命令，如 "show themes from last week"、"create memory trace for 30 days"、"refresh memory links for 30 days"。

📚 详细文档

调试

日志文件位于 logs/ 目录下：

server-YYYY-MM-DD.log（协议日志）
debug-YYYY-MM-DD.log（操作日志）

tail -f logs/debug-$(date +%Y-%m-%d).log  # 实时查看日志
grep ERROR logs/debug-*.log                # 查找错误信息
grep "similarity" logs/debug-*.log         # 调试反向链接

故障排除

服务器问题：检查 .env 文件是否存在，以及 DIARY_PATH 和 PLANNER_PATH 是否已设置。直接运行 ./start-server.sh 进行测试。
Ollama问题：使用 curl http://localhost:11434/api/tags 验证Ollama是否正在运行。拉取模型：ollama pull llama3.1:latest。
无反向链接：需要至少2个具有相似主题（重叠度 >8%）的条目。确保“Brain Dump”部分有足够的内容（>50个字符）。检查：grep "Brain Dump" logs/debug-*.log。
超时问题：对于推理模型，增加 OLLAMA_TIMEOUT（90+）和 OLLAMA_NUM_PREDICT（2000+）。

工作原理

本地AI处理：Ollama在本地处理日记条目，内容不会离开用户的设备。
基于日历分析：分析过去3个日历日（而非仅仅是最后3个条目）。
头脑风暴优先：优先分析用户的写作内容，而非回答的提示。
日期引用：AI引用 [Day 1]/[Day 2] 并转换为 [[2025-10-07]] 反向链接。
智能链接：使用Jaccard相似度连接主题重叠度 >8% 的条目。
周日总结：每周提供5个总结提示（相比每日3个）。
待办事项提取：AI从头脑风暴内容中识别行动项。

条目格式

每个日记条目（YYYY-MM-DD.md）具有以下纯文本标题：

## Reflection Prompts
**1. Question with [[2025-10-06]] backlink (reason)...**

---

## Brain Dump
Your thoughts, experiences, observations...

---

## Memory Links
**Temporal connections:** [[2025-10-05]] • [[2025-10-04]]
**Topic tags:** #career-growth #self-reflection

📄 许可证

本项目采用MIT许可证，要求Python 3.13+、FastMCP 2.12.4+ 和Ollama。

obsidian-diary-mcp