Automatic Vault Generation In Obsidian

带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服务器构建，用于直接操作保险库

设置

1. 安装依赖项：

pip install -r requirements.txt

1. 设置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
)

运作原理

1. 结构生成：创建具有相互联系的主题网络
2. 内容生成：使用Obsidian MCP服务器生成包含内容（或模板）的完整笔记
3. 链接创建：在相关注释之间建立双向链接
4. 中心注释：创建连接到多个主题的中心中心注释
5. 配置：设置针对图形视图优化的黑曜石配置

图形视图

生成vault后：

1. 打开黑曜石的保险库
2. 按 Ctrl+G （或 Cmd+G 在Mac上）打开图形视图
3. 使用筛选器选项进行探索：

- 标签 - 孤儿 - 未链接的提及

1. 单击节点在注释之间导航
2. 在中调整图形设置 .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许可证-可根据需要自由修改和使用