┌─────────────────────────────────────────────────────────┐
│                     docker compose up                    │
├─────────────────────────────────────────────────────────┤
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────────┐  │
│  │ Meilisearch │  │  Wiki API   │  │    Web UI       │  │
│  │  (search)   │◄─│  (MCP+REST) │◄─│   (browser)     │  │
│  │  :7700      │  │  :3000      │  │   :80           │  │
│  └─────────────┘  └──────┬──────┘  └─────────────────┘  │
│                          │                               │
│  ┌───────────────────────┴───────────────────────────┐  │
│  │  Volumes: content/ (markdown), data/ (SQLite)     │  │
│  └───────────────────────────────────────────────────┘  │
└─────────────────────────────────────────────────────────┘
         ↑                              ↑
    🤖 AI Agents (MCP)            👤 Humans (Browser)
    pi, Claude, Cursor...         View & Edit

git clone https://github.com/Dreamernosleep/wiki-mcp.git
cd wiki-mcp
npm run setup

git clone https://github.com/Dreamernosleep/wiki-mcp.git
cd wiki-mcp
cp .env.example .env     # optional: edit ports and MEILISEARCH_KEY
docker compose up -d     # Meilisearch + API + Web UI

# Open http://localhost in your browser!

# Prerequisites: Node.js 22+, Docker (for Meilisearch)

# Install dependencies
npm install

# Start Meilisearch
docker run -d -p 7700:7700 getmeili/meilisearch

# Run the API in development mode (http://localhost:3000)
npm run dev

# In a second terminal, run the web UI (http://localhost:5173, proxies /api to :3000)
cd ui && npm install && npm run dev

npm install && npm run build

# Run as MCP server (stdio)
MCP_TRANSPORT=stdio node dist/server.js

{
  "mcpServers": {
    "wiki": {
      "command": "node",
      "args": ["/path/to/wiki-mcp/dist/server.js"],
      "env": {
        "MCP_TRANSPORT": "stdio",
        "MEILISEARCH_URL": "http://localhost:7700"
      }
    }
  }
}

{
  "mcpServers": {
    "wiki": {
      "url": "http://localhost:3000/mcp"
    }
  }
}

wiki-mcp/
├── .github/                # GitHub Actions, issue templates
├── src/
│   ├── server.ts           # MCP + REST API server
│   ├── db.ts               # SQLite (graph, metadata)
│   ├── files.ts            # Markdown file I/O
│   ├── search.ts           # Meilisearch client
│   ├── watcher.ts          # File watcher (auto-sync)
│   └── sync.ts             # Manual sync script
├── ui/                     # Web UI (Vite + React + shadcn/ui)
│   ├── src/
│   │   ├── App.tsx         # App state and layout
│   │   ├── components/     # Sidebar, editor, preview, dialogs (+ ui/ from shadcn)
│   │   ├── lib/            # API client, markdown rendering
│   │   └── styles/
│   │       ├── brand.css   # ★ All colours, radius, fonts — edit to re-theme
│   │       └── index.css   # Tailwind + token mapping
│   ├── BRANDING.md         # How to change colours / name
│   ├── Dockerfile          # Builds the bundle, serves it with nginx
│   └── nginx.conf.template # Serves the app and proxies /api to the API
├── content/                # Your wiki (markdown files)
│   ├── finance/
│   ├── operations/
│   ├── service/
│   └── clients/            # Custom categories!
├── data/                   # SQLite database
├── docker-compose.yml      # One-command setup
├── Dockerfile              # Wiki API container
└── README.md

---
id: abc123-uuid
category: finance
slug: q4-budget
title: Q4 Budget Planning
created: 2026-10-27
updated: 2026-10-27
created_by: agent
---

# Q4 Budget Planning

The Q4 budget depends on [[operations/procurement]] timelines.

## Key Figures
- Revenue target: $2.5M

See [[operations/procurement]] for details.
Or use full path: [[finance/expense-policy]]

# Run tests
npm test

# Test MCP client
npm run test:mcp

# Manual sync (rebuild DB from files)
npm run sync

# Docker commands
npm run docker:build
npm run docker:up
npm run docker:down
npm run docker:logs