带MCP的黑曜石保险库生成器
如果您需要使用Obsidian MCP服务器生成完整笔记 –用于研究、学习、知识库或探索主题–此工具提供了具有丰富互连的自动化vault生成模板。你可以进一步实现api调用来生成完整的笔记，但这只是一个模板。
File structure that was generated
Picture of one of the enteries
Picture of the obsidian map
特性
- 自动创建保险库：从单个主题提示生成整个Vault
- 丰富的互联：为图形可视化在相关注释之间创建双向链接
- AI驱动的内容：使用OpenAI或其他LLM API生成笔记内容（模板可作为回退）
- 图形视图优化：为Obsidian的图形视图配置了正确的链接格式
- MCP集成：基于黑曜石MCP服务器构建，用于直接操作保险库
设置
- 安装依赖项：
pip install -r requirements.txt- 设置API密钥 （可选，用于生成完整保险库的AI生成内容）：
export OPENAI_API_KEY="your-api-key-here"或者使用Anthropic：
export ANTHROPIC_API_KEY="your-api-key-here"如果没有提供API密钥，生成器将使用基于模板的内容。
用法
基本用法
python vault_generator.py --topic "Machine Learning" --vault-name "ML-Knowledge-Base"高级选项
python vault_generator.py \
--topic "Quantum Computing" \
--vault-name "Quantum-Vault" \
--notes 50 \
--density 0.5 \
--vault-path ~/Obsidian-Vaults \
--api-key your-api-key参数
--topic：保险库的主要主题（必填）--vault-name：vault文件夹的名称（默认值：“知识库”）--notes：要创建的注释数（默认值：30）--density：连接密度介于0.0和1.0之间（默认值：0.4）
- 更高=互联性更强 - 推荐：0.3-0.6用于良好的图形可视化
--vault-path：Vault的基本目录（默认：~/黑曜石Vault）--api-key：LLM API密钥（或使用环境变量）
程序化使用
from vault_generator import VaultGenerator
generator = VaultGenerator(
vault_base_path="~/Obsidian-Vaults",
api_key="your-api-key" # optional
)
vault_path = generator.create_interconnected_vault(
vault_name="My-Knowledge-Vault",
main_topic="Artificial Intelligence",
num_notes=40,
connection_density=0.45
)运作原理
- 结构生成：创建具有相互联系的主题网络
- 内容生成：使用Obsidian MCP服务器生成包含内容（或模板）的完整笔记
- 链接创建：在相关注释之间建立双向链接
- 中心注释：创建连接到多个主题的中心中心注释
- 配置：设置针对图形视图优化的黑曜石配置
图形视图
生成vault后：
- 打开黑曜石的保险库
- 按
Ctrl+G（或Cmd+G在Mac上）打开图形视图 - 使用筛选器选项进行探索：
- 标签 - 孤儿 - 未链接的提及
- 单击节点在注释之间导航
- 在中调整图形设置
.obsidian/graph.json用于定制
输出
一个典型的保险库包含：
- README.md：带有所有主题链接的索引注释
- 知识中心.md：中央互连点
- 30+个相互关联的音符：每个都有多个双向链接
- 黑曜石配置：针对图形可视化进行了优化
API提供商
目前支持：
- 开放人工智能 （默认）-通过
openai包裹 - Anthropic -via
anthropic包（扩展content_generator.py)
要添加更多提供程序，请扩展 ContentGenerator 类。
需求
- Python 3.8+
- 已安装黑曜石（查看保险库）
- LLM API密钥（可选，返回到模板）
故障排除
没有API密钥？ 生成器将使用基于模板的内容生成。
图形视图不显示连接？ 确保：
- 笔记使用
[[double brackets]]对于链接 - 黑曜石中启用了图形视图
- 检查
.obsidian/graph.json配置
连接太多/太少？ 调整 --density 参数：
- 较低（0.2-0.3）=连接较少，图形更清晰
- 更高（0.5-0.7）=连接更多，网络更密集
- 推荐值：0.3-0.6
关于
如果您需要使用Obsidian MCP服务器生成完整笔记 –用于研究、学习、知识库或探索主题–此工具提供了具有丰富互连的自动化vault生成。
Obsidian MCP服务器处理保管库操作，使您能够专注于内容探索，而不是手动设置。
许可证
MIT许可证-可根据需要自由修改和使用