English Français العربية

com.seanwinslow/vault-knowledge

Registre officiel Recherche et web

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

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

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

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  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.

Questions fréquentes

Qu'est-ce que com.seanwinslow/vault-knowledge ?

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

Comment installer com.seanwinslow/vault-knowledge ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add vault-knowledge -- npx -y @swins/vault-knowledge-mcp@0.1.0. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour com.seanwinslow/vault-knowledge ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

com.seanwinslow/vault-knowledge est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient com.seanwinslow/vault-knowledge ?

Il est publié par seanwinslow28. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.