Server Mode

The server provides automatic file monitoring, MCP functionality, and A2A agent support.

Starting the Server

The serve command requires at least one service flag. You can enable file monitoring, MCP server, A2A server, or any combination:

MCP Server Only

haiku-rag serve --mcp

Transport options:

Default - Streamable HTTP transport on port 8001
--stdio - Standard input/output transport
--mcp-port - Custom port (default: 8001)

A2A Server Only

haiku-rag serve --a2a

Options:

--a2a-host - Host to bind to (default: 127.0.0.1)
--a2a-port - Port to bind to (default: 8000)

See A2A documentation for details on the conversational agent.

File Monitoring Only

haiku-rag serve --monitor

All Services

haiku-rag serve --monitor --mcp --a2a

This will start file monitoring, MCP server on port 8001, and A2A server on port 8000.

File Monitoring

Configure directories to monitor in your haiku.rag.yaml:

storage:
  monitor_directories:
    - /path/to/documents
    - /another/path

Then start the server:

haiku-rag serve --monitor

Monitoring Features

Startup: Scans all monitored directories and adds new files
File Added/Modified: Automatically parses and updates documents
File Deleted: Removes corresponding documents from database

Filtering Files

You can filter which files to monitor using gitignore-style patterns:

storage:
  monitor_directories:
    - /path/to/documents

  # Ignore patterns (exclude files)
  monitor_ignore_patterns:
    - "*draft*"         # Ignore draft files
    - "temp/"           # Ignore temp directory
    - "**/archive/**"   # Ignore archive directories

  # Include patterns (whitelist files)
  monitor_include_patterns:
    - "*.md"           # Only markdown files
    - "**/docs/**"     # Files in docs directories

Pattern behavior:

Extension filtering is applied first (only supported file types)
Include patterns create a whitelist (if specified)
Ignore patterns exclude files
Both can be combined for fine-grained control

Supported Formats

The server can parse 40+ file formats including:

PDF documents
Microsoft Office (DOCX, XLSX, PPTX)
HTML and Markdown
Plain text files
Code files (Python, JavaScript, etc.)
Images (processed via OCR)
And more...

URLs are also supported for web content.

2.4 KiB Raw Blame History