Zettelkasten MCP Server

Overview

基本能力

产品定位

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 工具更新数据库。

使用教程

使用依赖

# 克隆仓库
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 文件

cp .env.example .env

调试方式

# 启动服务器
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/

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。