LLM-WikiMind MCP Setup Skill
Set up the LLM-WikiMind MCP server — a local knowledge base built on Karpathy's LLM Wiki pattern.
What you get: 5 MCP tools (wiki_search, wiki_get, wiki_list, wiki_ingest_note, wiki_domains) backed by BM25 full-text search over your local Markdown files. No embeddings, no vector DB, no cloud.
Trigger phrases
- "Install WikiMind" / "Set up my knowledge base MCP"
- "Configure wiki-kb" / "llm-wikimind setup"
- "安装知识库 MCP" / "配置 wiki-kb" / "搭建个人知识库"
Installation Workflow
Step 1: Install the only dependency
pip3 install qmd
Step 2: Clone the repo
git clone https://github.com/HAL-9909/llm-wikimind
cd llm-wikimind
Step 3: Initialize the wiki
Run the interactive setup — it will ask where to store the knowledge base and handle everything else:
./wikimind init
Options:
| Command | When to use |
|---|
./wikimind init | Create a fresh wiki (interactive, asks for path) |
./wikimind init ~/my-notes --adopt | Adopt an existing Markdown directory |
init automatically:
- Creates the standard wiki directory structure
- Copies the MCP server and watcher into the wiki
- Builds the initial BM25 search index
- Prints the exact config snippet to paste into the AI client
Step 4: Register the MCP server
The init command prints the exact snippet. For reference:
CatDesk / OpenClaw:
catdesk mcp add --name wiki-kb --json '{
"command": "python3",
"args": ["<WIKIMIND_ROOT>/.wiki-mcp/server.py"],
"env": {"WIKIMIND_ROOT": "<WIKIMIND_ROOT>"}
}'
Replace <WIKIMIND_ROOT> with the path chosen in Step 3 (e.g. ~/Documents/wiki).
Claude Desktop — add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"wiki-kb": {
"command": "python3",
"args": ["<WIKIMIND_ROOT>/.wiki-mcp/server.py"],
"env": { "WIKIMIND_ROOT": "<WIKIMIND_ROOT>" }
}
}
}
Step 5: Start the auto-sync watcher
./wikimind start
Auto-start on login:
echo '/path/to/llm-wikimind/wikimind start > /dev/null 2>&1' >> ~/.zshrc
Step 6: Verify
./wikimind status
Expected output:
→ Wiki root: ~/Documents/wiki
✓ Wiki exists — 1 domain(s), 3 pages
✓ Watcher running (pid 12345)
✓ qmd installed
MCP Tools Reference
Once registered, these 5 tools are available to any MCP-compatible AI client:
| Tool | Description |
|---|
wiki_search | BM25 full-text search across all domains |
wiki_get | Read a specific page in full |
wiki_list | List pages by domain and/or type |
wiki_ingest_note | Write a new page + rebuild index + sync cache |
wiki_domains | List all registered domains and their trigger keywords |
Auto-update: always in sync
The watcher runs in the background and keeps everything current automatically:
- Add a new domain folder → detected within 10 seconds → MCP tool descriptions updated
- Edit
DOMAIN.md keywords → AI knows about the change in the next conversation
- AI writes a new page via
wiki_ingest_note → index rebuilt automatically
No restarts. No manual config changes.
Adding knowledge after setup
Install the companion ingest skill:
npx clawhub@latest install wikimind-ingest
Then just say: "Add this to my knowledge base: [paste content or URL]"
Troubleshooting
qmd: command not found → Run pip3 install qmd
MCP server not responding → Check ./wikimind status and ensure WIKIMIND_ROOT is set correctly
Watcher not running → Run ./wikimind start; add to ~/.zshrc for auto-start
New domain not detected → Ensure DOMAIN.md has a keywords frontmatter field; check ./wikimind status
