> Zero Config, Auto-Indexing, Semantic Search, Infinite Evolution.

Local Document Search & MCP

Index your local Markdown, TXT, and RST documents into seekdb. Provide MCP service for AI tool integration with real-time file watching and a full-featured web dashboard.

Python 3.11+ seekdb MCP Protocol React + Tailwind

Capabilities

Everything you need to turn local documents into an AI-accessible knowledge base.

Semantic Search

Vector-based semantic search understands query intent, not just keyword matching. Supports hybrid, vector, and fulltext modes.

🔄

Real-time Sync

Automatically watches directories for changes. New, modified, or deleted files are indexed in real time with 0.5s debounce.

🧩

MCP Integration

Exposes MCP service via both stdio and SSE transports. Works with Claude Code, Cursor, and any MCP-compatible AI tool.

📄

Smart Chunking

Intelligent semantic chunking: Markdown by headings, TXT by paragraphs, RST by sections. Handles oversized text automatically.

🔄

Multi-Collection

Each watched directory maps to an independent collection. Scoped search or cross-collection merge with score normalization.

🌐

Web Dashboard

Full-featured web UI: search, document management, configuration editing, and real-time log streaming via WebSocket.

Quick Start

Get up and running in three commands.

Install

Clone and install with pip.

pip install -e .

Initialize

Create config directory and database.

smm init

Import

Index your documents.

smm import /path/to/docs

Launch

Start web UI + file watcher.

smm serve --daemon
terminal
# Install dependencies
pip install -e ".[dev]"

# Initialize configuration
smm init

# Import documents from a directory
smm import ~/my-notes

# Start web UI with file watcher (background)
smm serve --daemon

# Or start MCP server for AI tools
smm mcp

# Search from CLI
smm search "how to deploy" --mode hybrid

# Check daemon status
smm status

Architecture

CLI + Daemon architecture with clear component boundaries.

CLI
smm init / import / search / mcp / status / stop
Daemon
FastAPI Web UI + File Watcher + SSE MCP Endpoint
seekdb
Embedded or Server mode — HNSW vector index + fulltext index
MCP
search / import / get_document / list_collections / reindex / status
Skill
Claude Code skill for natural language interaction

Tech Stack

Built with modern, battle-tested tools.

🐍 Python 3.11+
🔎 seekdb (pyseekdb)
🚀 FastAPI
⚡ Uvicorn
📄 click (CLI)
👁 watchfiles
🤖 MCP SDK
⚛ React 18
⚡ Vite
🌈 Tailwind CSS
📌 YAML config
🔒 Claude Code skill