XKnow Knowledge Base

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

Search and explore source-backed SEO, SaaS, and LLM-wiki knowledge from the XKnow knowledge base.

التثبيت

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

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

التوثيق

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

المحتويات
  1. xknow-mcp
  2. Quick start
  3. Tools
  4. Two knowledge layers
  5. How it works
  6. Development
  7. Links
  8. License

xknow-mcp

An MCP server for the XKnow Knowledge Base — a curated, cross-linked body of SEO, SaaS, and LLM-wiki knowledge. Give any MCP-capable agent (Claude, Cursor, Cline, opencode, and others) the ability to search and cite it.

  • Local and private. Runs on your machine over stdio. No server, no account, no API key.
  • Static data. The free layer is a snapshot of the public XKnow guides, bundled with the package. Nothing is fetched at query time.
  • Graph-aware. Beyond keyword search, explore_concept walks the cross-links between notes, so an agent can follow a topic instead of getting a flat list.

Quick start

Add it to your MCP client.

Claude Desktop (claude_desktop_config.json), Cursor, Cline, and most clients:

{
  "mcpServers": {
    "xknow": {
      "command": "npx",
      "args": ["-y", "xknow-mcp"]
    }
  }
}

Claude Code

claude mcp add xknow -- npx -y xknow-mcp

opencode (opencode.json)

{
  "mcp": {
    "xknow": { "type": "local", "command": ["npx", "-y", "xknow-mcp"], "enabled": true }
  }
}

Then ask your agent something like:

"Use the xknow tools to explain keyword difficulty and cite the source." "Search XKnow for SaaS pricing models and summarise the trade-offs."

Tools

ToolWhat it does
search_knowledgeRanked search over the knowledge base. Returns titles, snippets, and URLs.
get_pageFull text of one note by title or slug (preserves [[wikilinks]]).
explore_conceptA note plus its outbound links and backlinks — walks the knowledge graph.
list_topicsLists every note grouped by section (seo, saas, blog).
lint_rulesThe XKnow SEO/SaaS content self-check rubric — each rule with priority (P0–P3), reasoning, fix, and the knowledge-base notes that back it.
citeReturns the canonical citation (title, description, URL) for a note.

Two knowledge layers

LayerContentHow
Free (default)The 57 public XKnow guides and blog postsBundled snapshot — just npx -y xknow-mcp
Full vaultYour purchased XKnow Knowledge Base (500+ linked notes)npx -y xknow-mcp --vault /path/to/SEO-SaaS-Vault

The full-vault mode reads a local folder of Markdown notes, so your purchased copy never leaves your machine. Set it once with the XKNOW_VAULT environment variable if you prefer:

export XKNOW_VAULT="/path/to/SEO-SaaS-Vault"
npx -y xknow-mcp

How it works

xknow-mcp is a Node.js stdio server. The free layer is a static JSON snapshot generated from the public site and bundled in the package (data/knowledge.json); search is a small, dependency-free ranking pass over the bundled notes. Vault mode parses Markdown notes from a local folder on the fly. No network calls, no vector database, no telemetry.

Development

npm install
npm run build:data   # refresh data/knowledge.json from https://xknow.org/mcp/knowledge.json
npm run build        # tsc
npm run smoke        # exercise every tool over a real stdio connection

# also test against a local vault
SMOKE_VAULT=/path/to/SEO-SaaS-Vault npm run smoke

License

MIT — see LICENSE.

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

ما هو XKnow Knowledge Base؟

Search and explore source-backed SEO, SaaS, and LLM-wiki knowledge from the XKnow knowledge base.

كيف أثبّت XKnow Knowledge Base؟

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

هل يحتاج XKnow Knowledge Base إلى مفتاح API؟

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

هل XKnow Knowledge Base مفتوح المصدر؟

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

من يصون XKnow Knowledge Base؟

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

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