md

CLI for indexing and searching local markdown files via Meilisearch with MCP server support.

Quick Start

1. Install

curl -fsSL https://bun.sh/install | bash
bun install -g @aaronshaf/md

2. Start Meilisearch

docker run -d -p 7700:7700 \
  -v ~/.meilisearch/data:/meili_data \
  getmeili/meilisearch:latest

3. Index and Search

md index --path ~/docs
md search "query"

Commands

md status              Check if Meilisearch is running
md search <query>      Search indexed content
md index               Build/rebuild index
md embed               Generate embeddings for semantic search
md source              Manage registered sources for MCP server
md mcp [sources...]    Start MCP server

Run md <command> --help for command-specific options.

MCP Server

# Register sources (one-time setup)
md source add -s ~/docs -d "Documentation"
md source add -s ~/wiki -d "Team wiki"
md source list

# Start MCP server (uses registered sources)
md mcp

# Or specify sources directly (overrides registered)
md mcp -s ~/docs -d "Documentation"

# HTTP mode for remote access (Claude web UI)
export MD_MCP_API_KEY="$(openssl rand -hex 32)"
md mcp --http

# Add to Claude Code
claude mcp add kb -- md mcp

Documentation

See docs/ for comprehensive documentation:

• Getting Started - Full setup guide
• PRD - Product requirements and specifications
• ADR - Architecture decision records

See Also

• qmd - Similar tool with opposite tradeoffs: qmd does LLM work at query time (reranking, query expansion), while md does LLM work at index time (embeddings) for fast queries.