Omega Obsidian

欧米茄黑曜石

黑曜石拱顶的持久语义记忆。你的编码代理会记住它从你的笔记中学到了什么。

为什么是欧米茄黑曜石？

现有的Obsidian MCP服务器允许代理读取您的文件。欧米茄黑曜石让代理商 记住 他们通过语义搜索从你的数据库中学习到了什么。

区别：

安装

pip install omega-obsidian

对于更高质量的嵌入（通过ONNX的bge-small-en-v1.5），请与OMEGA引擎一起安装：

pip install omega-obsidian[omega]

没有 [omega]，服务器使用内置的TF-IDF回退，不需要额外的依赖关系。

MCP配置

克劳德代码

添加到您的Claude Code MCP设置中(~/.claude.json 或项目 .claude/settings.json):

{
  "mcpServers": {
    "omega-obsidian": {
      "command": "omega-obsidian",
      "args": ["--vault-path", "/path/to/your/obsidian/vault"],
      "env": {}
    }
  }
}

或者使用环境变量代替 --vault-path:

{
  "mcpServers": {
    "omega-obsidian": {
      "command": "omega-obsidian",
      "env": {
        "OBSIDIAN_VAULT_PATH": "/path/to/your/obsidian/vault"
      }
    }
  }
}

光标

添加 .cursor/mcp.json:

{
  "mcpServers": {
    "omega-obsidian": {
      "command": "omega-obsidian",
      "args": ["--vault-path", "/path/to/your/obsidian/vault"]
    }
  }
}

帆板运动

添加到您的Windsurf MCP配置中：

{
  "mcpServers": {
    "omega-obsidian": {
      "command": "omega-obsidian",
      "args": ["--vault-path", "/path/to/your/obsidian/vault"]
    }
  }
}

工具

omega黑曜石暴露出6个MCP工具：

vault_search

在所有索引的保险库笔记中进行语义搜索。返回按与分数和内容片段的相关性排序的匹配项。

query: "authentication flow design"
limit: 5

vault_read

通过特定笔记的vault相对路径读取该笔记。返回包含解析的frontmatter、标签和维基链接的完整内容。

path: "Projects/auth-redesign.md"

vault_remember

将新内存或笔记从代理上下文存储到vault中。使用frontmatter创建一个markdown文件并立即对其进行索引。

title: "Auth API Decision"
content: "We decided to use JWT with refresh tokens..."
tags: ["architecture", "auth"]
folder: "Decisions"

vault_graph

通过反向链接、维基链接和共享标签获取与给定笔记相关的笔记。有助于探索知识库中的联系。

path: "Projects/auth-redesign.md"

vault_index

重新索引整个保险库。为所有文件重建嵌入。在代理外部对vault进行批量更改后运行此操作。

vault_recent

获取最近修改的笔记，按修改时间排序（最新的优先）。

limit: 10

运作原理

1. 首次启动：欧米伽黑曜石会走过你的黑曜岩金库，解析每一个 .md 文件（提取frontmatter、wikillinks和标签），生成语义嵌入，并将所有内容存储在本地SQLite数据库中 ~/.omega-obsidian/index.db.

1. 后续创业：只有新的或修改过的文件才会重新索引（增量）。索引在会话之间持续存在，因此启动速度很快。

1. 语义搜索：搜索时，使用相同的模型嵌入查询，并通过余弦相似度与所有注释嵌入进行比较。这可以按含义查找注释，而不仅仅是关键字匹配。

1. 知识图谱：维基链接([[note]])和标签(#tag)被解析和存储，使图遍历能够找到相关的注释。

1. 回写：The vault_remember 该工具在您的保险库中使用适当的frontmatter创建真正的黑曜石兼容标记文件，这样您的代理人的记忆就会成为您知识库的一部分。

嵌入后端

omega黑曜石支持两个嵌入后端：

• OMEGA发动机 （推荐）：通过ONNX使用bge-small-en-v1.5进行高质量的384维嵌入。安装方法： pip install omega-obsidian[omega].
• TF-IDF回退：一个内置的哈希TF-IDF嵌入器，不需要额外的依赖关系。质量较低，但适用于所有地方。

服务器会自动检测哪个后端可用，并使用最佳后端。

配置

由OMEGA供电

欧米茄黑曜石使用嵌入引擎 欧米茄，用于AI编码代理的持久内存。如果您需要完整的代理内存（而不仅仅是黑曜石金库搜索），请查看OMEGA。