xknow-mcp
XKnow · MCP server page · Source · npm · MCP Registry
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
Two knowledge layers
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.