Overview
llm-wiki-mcp (flsteven87) is a minimal MCP server with 4 deterministic tools for LLM Wiki file operations. It is the “Local file MCP” pattern in the comprehensive report — single-user, single-machine read/write/log access to the wiki via the Model Context Protocol.
Key Facts
- Tools: 4 deterministic operations (read / write / log + etag conflict detection, path containment)
- Design: deterministic scripts first, LLM only for judgment (matches community best practice “deterministic operations before LLM”)
- Use: Pattern B (MCP-Augmented) entry point for power users
- License: MIT
- Status: alpha (v0.1.1)
Features
Core Architecture
- MCP server (stdio transport) — local filesystem backend, 4 tools: wiki_read, wiki_write_page, wiki_log_append, wiki_inventory
- Schema-blind design — server enforces mechanics (atomic writes, etags, path containment), not content shape; schema lives in wiki/CLAUDE.md
- Python API — WikiStorage Protocol for custom backends (SQLite, Notion, GDrive, test fakes)
Quality & Governance
- Atomic writes — tmp-file + fsync + rename for pages; O_APPEND single-write for log entries
- Optimistic concurrency — etag CAS (sha256(body) || mtime_ns) prevents lost updates; WikiConflictError on mismatch
- Path containment security — slug regex validation + realpath check blocks symlink-escape attacks (CVE-2025-53109 class)
- Append-only log — format-locked log line: [YYYY-MM-DD] op | Title
Integration
- Claude Code skills — 4 bundled skills: wiki-init (scaffolder), wiki-ingest, wiki-query, wiki-lint
- Plugin installable —
claude plugin marketplace add+claude plugin install - Multi-client support — works with Claude Code, Claude Desktop, Cursor (tools only, no skills)
- Skill reads schema on every run — wiki/CLAUDE.md evolves without reinstall
Data & Storage
- Local filesystem only — no cloud, no database, plain markdown files
- Wiki layout — raw/ (immutable sources) + wiki/ (pages/, log.md, index.md, CLAUDE.md)
- No Layer 3 validation — intentionally silent on content shape per Karpathy’s gist
Relationships
- model-context-protocol — implemented-by: it is an MCP server, the canonical agent-tool bridge
- llm-wiki — enables: gives an agent structured read/write access to the wiki
- claude-code — operates-with: typical client; pairs with CLAUDE.md as the schema layer
- cognee — contradicts: llm-wiki-mcp is minimal/local; Cognee MCP is graph/14-tools
Implications
llm-wiki-mcp is the pragmatic bridge between this vault’s markdown files and an agent via MCP — directly relevant to the user’s “too manual” complaint, since it lets an agent operate the wiki without terminal hand-holding.
External Links
- Repository: https://github.com/flsteven87/llm-wiki-mcp