┌─────────────────────────────────────────────────────────┐
│                     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

curl -fsSL https://raw.githubusercontent.com/Dreamernosleep/wiki-mcp/main/setup.sh | bash

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; gitignored, created on first start)
│   ├── _templates/         # Page templates (see below)
│   ├── companies/          # One page per client organization
│   ├── contacts/           # People at those companies
│   ├── accounts/           # Engagements: status, services, timeline
│   ├── services/           # Your service catalog
│   └── engineering/        # Custom categories!
├── data/                   # SQLite database
├── docker-compose.yml      # One-command setup
├── Dockerfile              # Wiki API container
└── README.md

---
id: abc123-uuid
category: companies
slug: acme
title: Acme Inc
created: 2026-10-27
updated: 2026-10-27
created_by: agent
---

# Acme Inc

## Contacts
- [[contacts/jane-doe]] — CEO

## Accounts
- [[accounts/acme-website-redesign]] — active

---
name: Company profile
description: One page per client organization
category: companies      # optional: the category this template belongs to
default: true            # optional: preselected for new pages in that category
---
# {{title}}

## Overview
- Domain:
- Industry:

See [[acme]] for details.
Or use full path: [[companies/acme]]

# 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