Zettelkasten Organiser MCP

保管库管理员MCP

一个简单的MCP服务器，使用Zettelkasten方法帮助组织黑曜石金库中的笔记。专为与Gemini CLI和自定义Agent Skill配合使用而构建。

它做什么

此服务器使Gemini CLI能够通过以下方式管理您的黑曜石笔记：

• 在父文件（项目和技术堆栈）之间创建和链接注释
• 将笔记从暂存区移动到适当的位置
• 保持相关笔记之间的双向链接
• 自动为新父文件生成唯一ID

运作原理

服务器公开遵循特定工作流的工具（在 zettelkasten_organizer_skill/SKILL.md):

1. 从vault根目录读取新注释
2. 在中查找或创建相关父文件 002 Project/ 或 003 TechStack/
3. 在笔记和其父级之间创建双向链接
4. 将笔记移动到 Notes/ 目录
5. 记录活动

设置

1. 安装依赖项：

uv sync

1. 在中更新vault路径 mcp_server.py:

VAULT_ROOT = "/path/to/your/obsidian/vault"

1. 配置Gemini CLI以使用此MCP服务器（添加到您的MCP配置中）

可用工具

• read_file -阅读笔记内容
• glob -搜索与模式匹配的文件
• get_next_id -获取文件夹的下一个可用ID
• create_note -创建新笔记
• add_backlink -添加从父注释到子注释的链接
• prepend_text_to_file -在文件开头添加文本
• move_note -将笔记从一个位置移动到另一个位置

用法

只需将Gemini CLI指向vault根目录中的注释，并要求它对其进行组织。技能说明会自动指导Gemini完成整个过程。

需求

• Python 3.13+
• fastmcp
• 具有预期文件夹结构的黑曜石保险库
• Gemini CLI中启用zettelkasten_organizer技能