语义搜索插件

为Obsidian笔记提供基于AWS Bedrock和LanceDB的语义搜索功能,支持通过Claude MCP进行智能搜索和同步。

  • by glnds
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 glnds/obsidian-semantic-search

使用说明

黑曜石语义搜索

使用AWS基岩嵌入和LanceDB对黑曜石拱顶进行语义搜索。通过Claude MCP搜索,通过最小的黑曜石插件同步。

运作原理

Obsidian Vault
      │
      ▼
Sync Plugin ──► Python Backend ──► AWS Bedrock (embeddings)
                     │
                     ▼
                  LanceDB (local vector store)
                     │
                     ▼
               MCP Server ──► Claude

搜索:让克劳德按意思查找笔记,而不仅仅是关键字。
同步:通过命令面板从黑曜石触发索引。

组件

组件 描述
backend/ Python:嵌入、索引、MCP服务器、HTTP API
plugin/ 黑曜石插件:同步触发器、状态栏

需求

  • Python 3.11+
  • 具有基岩访问权限的AWS帐户(Titan Embeddeds V2)
  • 黑曜石1.0+

快速开始

1.安装后端

cd backend
pip install -e .

2.配置

创建 ~/.config/obsidian-semantic-search/config.toml:

[vault]
path = "/path/to/your/vault"

[bedrock]
region = "eu-west-1"

3.初始指标

obsidian-semantic-search reindex --full

4.启动后端

# HTTP API for Obsidian plugin
uvicorn obsidian_semantic_search.api:app --port 8765

5.配置Claude

添加到 claude_desktop_config.json:

{
  "mcpServers": {
    "obsidian-semantic": {
      "command": "python",
      "args": ["-m", "obsidian_semantic_search.server"]
    }
  }
}

6.安装黑曜石插件

复制 plugin/ 内容到 .obsidian/plugins/semantic-sync/ 并在设置中启用。

MCP工具

工具 说明
semantic_search 按含义查找注释
similar_notes 查找与给定注释类似的注释
reindex 触发完全或增量重新索引

成本

基岩泰坦嵌入:每1K代币约0.0001美元。
一个500张纸币的金库最初的索引成本约为0.05美元,目前每年不到1欧元。

许可证

麻省理工学院