知识库生成工具

一个基于Obsidian MCP服务器的自动化知识库生成工具,支持AI内容生成和丰富的笔记互连功能,适用于研究、学习和知识管理。

  • by Kennethenow1
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 Kennethenow1/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. 使用筛选器选项进行探索:
    • 标签
    • 孤儿
    • 未链接的提及
  4. 单击节点在注释之间导航
  5. 在中调整图形设置 .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许可证-可根据需要自由修改和使用