LLM Wiki

An Obsidian vault + MCP server that turns Claude into a personal knowledge compiler — it reads your research, extracts concepts, links ideas together, and answers questions from what it has learned.

---

Install

pip install -r mcp_server/requirements.txt

Add to %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "llm-wiki": {
      "command": "python",
      "args": ["C:\\Users\\nhata\\PycharmProjects\\llm-wiki\\mcp_server\\server.py"]
    }
  }
}

Restart Claude Desktop. Done.

---

How to use

Just talk to Claude naturally:

• "Here's an article about momentum trading — add it to the wiki" → Claude extracts concepts, creates/updates pages, links related ideas
• "What do we know about mean reversion?" → Claude searches the wiki and answers with citations
• "Find papers on reinforcement learning for trading" → Claude searches Arxiv, fetches relevant papers, saves them

Everything gets saved automatically. You don't need to learn any commands.

---

Features

Knowledge pages

Each topic gets its own Markdown file with structured frontmatter. Pages are linked with [[wikilinks]] so nothing is an island. Claude never creates a page without first checking if one already exists.

Notes are automatically routed to a typed subfolder based on their type field:

Type	Folder	Slug prefix	What it stores
daily	wiki/01-daily/	log-YYYY-MM-DD	Daily research anchor note
concept	wiki/02-concepts/	concept-	A technical idea or theory — definition, how it works, edge cases
source	wiki/03-sources/	source-, paper-	Summary of a book, paper, or article — key claims, quotes, context; also Arxiv papers
note	wiki/04-notes/	(fallback)	General notes, quick captures
strategy	wiki/04-notes/	strategy-	A trading strategy — setup, signals, risk rules, empirical notes
entity	wiki/04-notes/	entity-	A person, firm, or tool — background, notable work, opinions
project	wiki/05-projects/	project-	Project plans, tracking, milestones
idea	wiki/05-projects/	idea-	Brain dumps, explorations
decision	wiki/05-projects/	decision-	Why you chose approach X over Y — alternatives considered, reversibility
log	wiki/05-projects/	log-	Captured conversation insight
kaizen	wiki/05-projects/	kaizen-	System improvement notes

Synonym-aware search

Pages have an aliases field listing alternate names for the same concept:

aliases: ["mean reversion", "stat arb", "pairs trading"]

Searching for any of these terms finds the page — even if the query term never appears in the body text. This matters in quant where "momentum" = "trend following" = "time-series momentum" depending on the author.

Inbox for quick capture

Don't want to think about where something belongs right now? Claude drops it in vault/wiki/04-notes/ with a timestamp prefix and status: inbox in frontmatter. You can process it later, or ask Claude to sort through the inbox for you.

Daily research log

Every session can anchor to today's date via vault/wiki/01-daily/log-YYYY-MM-DD.md. Useful for tracking what you read, what questions came up, and what decisions were made on a given day.

Arxiv integration

Claude can search Arxiv by topic and fetch full paper metadata in one step. Papers are saved to vault/wiki/03-sources/ (as paper-<arxiv-id>.md) and automatically linked to related concept pages.

Auto-timestamp hook

Every time a wiki page is edited, the updated field in frontmatter is updated automatically — no need to remember. Requires merging hooks/hook-configs.json into ~/.claude/settings.json.

Semantic search (optional)

For fuzzy conceptual search beyond keyword matching:

npm install -g @tobilu/qmd
qmd collection add ./vault --name llm-wiki
qmd context add llm-wiki "Quant trading research vault"
qmd embed

Once set up, the index rebuilds automatically after each Claude session.

Vault health check

python hooks/validate-frontmatter.py vault/wiki

Checks all pages across all typed folders for missing required fields, invalid types, malformed slugs, and non-list aliases.

---

Vault layout

vault/
├── raw/                   # Original source text — never edited
├── wiki/                  # All compiled knowledge
│   ├── 01-daily/          # Daily research logs
│   ├── 02-concepts/       # Technical concepts
│   ├── 03-sources/        # Book / article / paper summaries + Arxiv papers
│   ├── 04-notes/          # General notes, strategies, entities, quick-captures
│   └── 05-projects/       # Projects, ideas, decisions, logs, kaizen
├── outputs/               # AI-generated answers and one-off reports
├── _index.md              # Auto-generated catalog
└── log.md                 # Activity history

Migration: If upgrading from an older version with a flat vault/wiki/, run wiki_migrate_folders() once to move existing files into the correct typed subfolders.

---

See CLAUDE.md for full agent conventions and workflow details.