wiki-mcp-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

Related MCP server: WikiStrata

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