mcpField
V
vault-knowledge

vault-knowledge

Local
github.com/seanwinslow28Memory & Knowledge0Updated 22w ago
Repository

About vault-knowledge

vault-knowledge is a local-first, read-only MCP server for querying an Obsidian vault’s typed knowledge graph. It searches concepts, surfaces contradictions between notes, and retrieves articles with resolved wikilinks.

Key features

  1. 01Ranked concept and connection search
  2. 02Find active graph contradictions
  3. 03Fetch articles with frontmatter and wikilinks
  4. 04Restrict reads to configured vault folders
  5. 05Synthetic sample vault included

Use cases

  1. 01Find concepts related to a question in a vault
  2. 02Spot conflicting claims across notes
  3. 03Retrieve an article with its linked context

MCP support

Exposes `search_concepts`, `find_contradictions`, and `get_article` as tools for MCP clients. It runs locally over stdio without authentication.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "com-seanwinslow-vault-knowledge": {
      "command": "npx",
      "args": [
        "-y",
        "@swins/vault-knowledge-mcp"
      ]
    }
  }
}
Run commandnpx -y @swins/vault-knowledge-mcp

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

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

Tools

3

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
limitintegerNoMaximum number of results to return (default 5).
querystringYesNatural-language query to search concept articles for.

Details

From the project README

vault-knowledge-mcp

A read-only MCP server that turns an Obsidian vault's typed knowledge graph into three tools any MCP client can call. Most knowledge tools can search. Few can tell you where your own notes disagree with each other. This one traverses a six-relation reasoning graph and surfaces the sharpest edge — contradicts. Local-first, stdio, no auth, no cloud, no native build.

The full reasoning lives in docs/EXPLANATION.md.

Tools

ToolReturns
search_concepts(query, limit=5)Semantically ranked concept/connection articles.
find_contradictions(scope='all'|'recent_30d')Active contradicts edges from the reasoning graph.
get_article(slug)One article with frontmatter, body, and resolved wikilinks.

Try it — zero config

Ships with a synthetic espresso vault, so it works the moment it installs.

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

Then ask: "find contradictions in the vault."

Point it at your own vault

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

Only knowledge/{concepts,connections,qa} is ever readable. Scope is config-only — never a request parameter, so a client can't widen it.

Requirements

Node ≥ 22.5 (built-in node:sqlite). search_concepts downloads the nomic-embed-text-v1.5 model once on first run.

License

MIT.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.