vault-knowledge

本地服务

github.com/seanwinslow28记忆与知识022 周前更新

代码仓库

关于 vault-knowledge

vault-knowledge 是面向 Obsidian 知识图谱的本地优先只读 MCP 服务。它可搜索概念、发现笔记间的矛盾，并获取带有已解析 wikilinks 的文章。

主要功能

01按相关性搜索概念和关联
02查找图谱中的有效矛盾
03获取含 frontmatter 和 wikilinks 的文章
04将读取范围限制在配置的 vault 文件夹
05附带合成示例 vault

适用场景

01在 vault 中查找与问题相关的概念
02发现笔记之间相互冲突的说法
03获取包含链接上下文的文章

MCP 相关

向 MCP 客户端提供 `search_concepts`、`find_contradictions` 和 `get_article` 工具。它通过 stdio 在本地运行，无需身份验证。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "com-seanwinslow-vault-knowledge": {
      "command": "npx",
      "args": [
        "-y",
        "@swins/vault-knowledge-mcp"
      ]
    }
  }
}

启动命令npx -y @swins/vault-knowledge-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@swins/vault-knowledge-mcp0.1.0stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
limit	integer	否	返回结果的最大数量（默认值为 5）。
query	string	是	用于搜索概念文章的自然语言查询。

详细介绍

vault-knowledge-mcp

一个只读 MCP 服务，可将 Obsidian 知识库中的类型化知识图谱转化为 3 个任何 MCP 客户端都能调用的工具。大多数知识工具都能搜索，但很少能指出你自己的笔记之间有哪些矛盾。这个工具会遍历包含 6 种关系的推理图谱，并找出最突出的边——contradicts。本地优先、使用 stdio、无需认证、无需云服务、无需原生构建。

完整的推理过程见 docs/EXPLANATION.md。

工具

工具	返回内容
`search_concepts(query, limit=5)`	按语义排序的概念／关联文章。
`find_contradictions(scope='all'\|'recent_30d')`	推理图谱中的有效 `contradicts` 边。
`get_article(slug)`	单篇文章，包含 frontmatter、正文和已解析的 wikilinks。

试用——零配置

内置合成的 espresso 知识库，安装后即可使用。

{
  "mcpServers": {
    "vault-knowledge": { "command": "npx", "args": ["-y", "@swins/vault-knowledge-mcp"] }
  }
}

然后询问：“找出知识库中的矛盾。”

指向你自己的知识库

{
  "mcpServers": {
    "vault-knowledge": {
      "command": "npx",
      "args": ["-y", "@swins/vault-knowledge-mcp"],
      "env": {
        "VAULT_DB": "/abs/path/.vault-index.db",
        "VAULT_ROOT": "/abs/path/vault"
      }
    }
  }
}

只有 knowledge/{concepts,connections,qa} 可读取。范围仅通过配置设置——绝不会作为请求参数，因此客户端无法扩大范围。