English Français العربية

com.seanwinslow/vault-knowledge

Official registry Search and web

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

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @swins/vault-knowledge-mcp
Claude Code 
claude mcp add vault-knowledge -- npx -y @swins/vault-knowledge-mcp@0.1.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "vault-knowledge": {
            "command": "npx",
            "args": [
                "-y",
                "@swins/vault-knowledge-mcp@0.1.0"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. vault-knowledge-mcp
  2. Tools
  3. Try it — zero config
  4. Point it at your own vault
  5. Requirements
  6. License

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.

Frequently asked questions

What is com.seanwinslow/vault-knowledge?

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

How do I install com.seanwinslow/vault-knowledge?

It runs on your machine. In Claude Code: claude mcp add vault-knowledge -- npx -y @swins/vault-knowledge-mcp@0.1.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does com.seanwinslow/vault-knowledge need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is com.seanwinslow/vault-knowledge open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains com.seanwinslow/vault-knowledge?

It is published by seanwinslow28. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.