Vault Knowledge MCP server

by seanwinslow.com·com.seanwinslow/vault-knowledge·v0.1.0

No reviews yet

Read-only MCP over a vault's typed knowledge graph: concept search, contradictions, article fetch.

B77/100grade B

Write a review Install

What users say

No reviews yet

Be the first

Safety scan

B77/100

full report

Adoption

New

0 stars

Reviews

Write one

Nobody has reviewed Vault Knowledge yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Vault Knowledge tools (3)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

find_contradictions
Traverse the typed reasoning graph for active 'contradicts' edges — the sharpest of six relation types. scope='all' or 'recent_30d'. Returns {from_slug, to_slug, confidence, surfaced_at, source_run_id}. Read-only.
get_article
Fetch one article by slug with frontmatter, body, and resolved inbound/outbound wikilinks. Reads only files under the configured knowledge allowlist. Read-only.
search_concepts
Semantically search the vault's concept, connection, and Q&A articles for a natural-language query. Returns ranked {slug, title, similarity_score, excerpt, last_modified}. Read-only.

Public scan report

scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it

no findings

Code scan11 source files scanned25/25
–Live reliabilityno gateway calls yet and no remote to proben/a
–Tool poisoningtools not inspected (local package is not executed); not countedn/a
Auth qualitylocal package, no credentials required12/15
Maintenancelast push 120 days ago8/15
Maintainer identitynamespace and repository owner differ; GitHub account older than a year5/10

Overall 77/100. Components that don't apply are left out of the denominator. Any critical finding is an F.Rubric Appeal a finding JSON

How Vault Knowledge compares

Against every graded Web search MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score: 77/100; higher than 55% of 3,470 Web search servers
Tools: 3; the typical Web search server has 5
Tools that change things: 0%; typical: 0%. Fewer write tools means less an agent can break

What its tools let an agent do: 3 read

Install Vault Knowledge in Claude Code, Cursor or VS Code

Runs npx -y @swins/vault-knowledge-mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add vault-knowledge -- npx -y @swins/vault-knowledge-mcp

Add to Cursor

What the publisher says

From the Vault Knowledge repository's README, as published. We do not edit it. Read it on GitHub

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

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.

Nothing above is checked by us. What we check is on the safety report.

Vault Knowledge: common questions

Is Vault Knowledge MCP server safe?: Mostly: it is graded B (77/100). Read the Vault Knowledge safety report
How do I install Vault Knowledge?: It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Vault Knowledge need an API key?: Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is Vault Knowledge maintained?: The last commit was 158 days ago (2026-05-30). The latest release is v0.1.0.
What can I use instead of Vault Knowledge?: Servers from other publishers that do the same job: Octocode MCP server, Crg MCP server and Shodh Memory MCP server.
How does Vault Knowledge compare with other Web search MCP servers?: safety score 77/100 (higher than 55% of 3,470 Web search servers); tools 3 (the typical Web search server has 5); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Vault Knowledge

Same job from other publishers: the closest match first, then the best rated.

Octocode
AI-powered code indexer with semantic search and knowledge graphs
More from Muvon →
not reviewed
Established
A
Crg
Token-efficient code review knowledge graph: semantic search and call-graph resolution.
not reviewed
Established
B
Shodh Memory
Cognitive memory for AI agents — semantic search, Hebbian learning, knowledge graphs.
not reviewed
Established
C
Eur Lex
Search EU legislation, CJEU case law, and treaties; traverse CELLAR graph; browse EuroVoc concepts.
More from cyanheads →
not reviewed
Established
A
Reverie
Graph memory that dreams: Neo4j knowledge-graph memory for AI agents with hybrid search
not reviewed
Established
B