基本能力
产品定位
Zettelkasten MCP Server 是一个知识管理工具，旨在帮助用户通过原子笔记和知识网络高效组织和管理信息。
核心功能
- 创建具有唯一时间戳 ID 的原子笔记
- 双向链接笔记以构建知识图谱
- 为笔记添加标签进行分类组织
- 通过内容、标签或链接搜索笔记
- 使用 Markdown 格式进行人类可读和编辑
- 与 Claude 通过 MCP 集成，实现 AI 辅助知识管理
- 双存储架构（Markdown 文件和 SQLite 数据库）
- 同步操作模型简化架构
适用场景
- 个人知识管理
- 学术研究和写作
- 项目管理和规划
- 创意和想法整理
工具列表
| 工具 | 描述 |
|---|---|
| zk_create_note | 创建新笔记 |
| zk_get_note | 通过 ID 或标题检索笔记 |
| zk_update_note | 更新现有笔记 |
| zk_delete_note | 删除笔记 |
| zk_create_link | 创建笔记间链接 |
| zk_remove_link | 删除笔记间链接 |
| zk_search_notes | 通过内容、标签或链接搜索笔记 |
| zk_get_linked_notes | 查找与特定笔记链接的笔记 |
| zk_get_all_tags | 列出系统中的所有标签 |
| zk_find_similar_notes | 查找与给定笔记相似的笔记 |
| zk_find_central_notes | 查找连接最多的笔记 |
| zk_find_orphaned_notes | 查找无连接的笔记 |
| zk_list_notes_by_date | 按创建/更新日期列出笔记 |
| zk_rebuild_index | 从 Markdown 文件重建数据库索引 |
常见问题解答
- 数据安全：建议定期备份笔记，因为软件是实验性的，可能存在数据丢失或损坏的风险。
- 直接编辑 Markdown 文件：如果直接编辑 Markdown 文件，需要运行
zk_rebuild_index工具更新数据库。
使用教程
使用依赖
```bash
克隆仓库
git clone https://github.com/entanglr/zettelkasten-mcp.git
cd zettelkasten-mcp
创建虚拟环境
uv venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
安装依赖
uv add "mcp[cli]"
安装开发依赖
uv sync --all-extras
```
安装教程
- 克隆仓库并进入项目目录
- 创建并激活虚拟环境
- 安装依赖
- 复制并编辑
.env文件
bash
cp .env.example .env
调试方式
```bash
启动服务器
python -m zettelkasten_mcp.main
或使用显式配置
python -m zettelkasten_mcp.main --notes-dir ./data/notes --database-path ./data/db/zettelkasten.db
运行测试
uv run pytest -v tests/
```
