Wiki Hub

wiki-mcp-hub is a lightweight TypeScript MCP search server for repo-local llm-wiki/ folders.

It is intentionally lexical-only:

• SQLite FTS5 search
• Markdown scanning
• no embeddings
• no reranker
• no LLM dependency
• no API keys

Quick Start

npm install
npm run build
cp config/wikis.example.yaml config/wikis.yaml

Edit config/wikis.yaml, then build the index:

npm run start -- index

Run the HTTP server:

npm run start -- serve --host 127.0.0.1 --port 38894

Search from the CLI:

npm run start -- search "deployment runbook"

Run the MCP stdio server:

npm run start -- mcp

Codex Plugin

This repository is also a Codex plugin root. The plugin files are:

• .codex-plugin/plugin.json
• .mcp.json
• skills/wiki-mcp-hub/SKILL.md

After installing the plugin, Codex can call:

• wiki_search
• wiki_reindex
• wiki_list_sources
• wiki_health

Configuration

config/wikis.yaml is local/private and ignored by git.

wikis:
  - name: project-a
    rootPath: /path/to/project-a
    indexedSubdirs: [llm-wiki]

global:
  indexDir: ./.wiki-index

Missing wiki roots are skipped by default when optional: true is set on a source.

HTTP API

• GET /health
• GET /sources
• GET /search?q=...&topK=5
• POST /index

Privacy

The index is local. Do not commit:

• config/wikis.yaml
• .wiki-index/
• real wiki contents
• .env