English Français العربية

com.seanwinslow/vault-knowledge

السجل الرسمي البحث والويب

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

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

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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.

الأسئلة الشائعة

ما هو com.seanwinslow/vault-knowledge؟

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

كيف أثبّت com.seanwinslow/vault-knowledge؟

يعمل على جهازك. في Claude Code: claude mcp add vault-knowledge -- npx -y @swins/vault-knowledge-mcp@0.1.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج com.seanwinslow/vault-knowledge إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل com.seanwinslow/vault-knowledge مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون com.seanwinslow/vault-knowledge؟

ينشره seanwinslow28. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.