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»).
xknow-mcpclaude mcp add xknow-knowledge-base -- npx -y xknow-mcp@1.0.2
{
"mcpServers": {
"xknow-knowledge-base": {
"command": "npx",
"args": [
"-y",
"xknow-mcp@1.0.2"
]
}
}
}
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
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_conceptwalks 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
| Tool | What it does |
|---|---|
search_knowledge | Ranked search over the knowledge base. Returns titles, snippets, and URLs. |
get_page | Full text of one note by title or slug (preserves [[wikilinks]]). |
explore_concept | A note plus its outbound links and backlinks — walks the knowledge graph. |
list_topics | Lists every note grouped by section (seo, saas, blog). |
lint_rules | The XKnow SEO/SaaS content self-check rubric — each rule with priority (P0–P3), reasoning, fix, and the knowledge-base notes that back it. |
cite | Returns the canonical citation (title, description, URL) for a note. |
Two knowledge layers
| Layer | Content | How |
|---|---|---|
| Free (default) | The 57 public XKnow guides and blog posts | Bundled snapshot — just npx -y xknow-mcp |
| Full vault | Your 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
Links
- Product page: https://xknow.org/mcp
- Knowledge base: https://xknow.org/vaults/seo
- Registry: https://registry.modelcontextprotocol.io/servers/io.github.techreone/xknow-mcp
- Source: https://github.com/techreone/xknow-mcp
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 الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.