Skip to content

Reference: CLI Commands

Quick Reference

Script Purpose
debug_multi_tenant.py Local testing and debugging
deploy_multi_tenant.py Docker deployment
trigger_all_syncs.py Force sync documentation sources
trigger_all_indexing.py Rebuild BM25 search indexes
cleanup_segments.py Remove stale search segments
sync_tenant_data.py Export/import tenant data

debug_multi_tenant.py

Purpose: Run the server locally for testing and debugging. Supports offline and online modes.

Synopsis: 

uv run python debug_multi_tenant.py [OPTIONS]

Options (excerpt from --help): - --tenant TENANT [TENANT ...] - --test {all,search,fetch,crawl,parity} - --host HOST / --port PORT - --enable-sync, --trigger-sync, --root, --root-test {all,list,describe,search,fetch}

Example (search smoke): 

uv run python debug_multi_tenant.py --tenant drf --test search

Actual output (2025-12-31): 

✅ Search successful, returned 5 results

deploy_multi_tenant.py

Purpose: Deploy the server to Docker.

Synopsis: 

uv run python deploy_multi_tenant.py --mode online

Actual output (2025-12-31): 

#17 naming to docker.io/pankaj28843/docs-mcp-server:multi-tenant done
🚀 Starting container on port 42042 in online mode...
✅ Deployment complete!
Server URL │ http://127.0.0.1:42042

trigger_all_syncs.py

Purpose: Force synchronization of documentation sources (online + git).

Actual outputs (2025-12-31): 

drf                            ✅ Sync cycle completed
aidlc-rules                    ✅ Git sync completed: 25 files, commit 5119d001

trigger_all_indexing.py

Purpose: Rebuild BM25 search indexes for tenants.

Actual outputs (2025-12-31): 

drf indexed 44 docs (1.08s)
django indexed 271 docs (7.59s)
mkdocs indexed 19 docs (0.45s)
aidlc-rules indexed 25 docs (0.30s)

Command: 

uv run python trigger_all_indexing.py --tenants drf django mkdocs aidlc-rules

cleanup_segments.py

Purpose: Remove stale or oversized search segments to reclaim disk space.

Synopsis: 

uv run python cleanup_segments.py [OPTIONS]

Options (from --help): - --tenant TENANT [TENANT ...] - --dry-run - --root ROOT

Actual output (2025-12-31, dry run): 

Deleted: 0 segments
Space reclaimed: 0 bytes

sync_tenant_data.py

Purpose: Export/import tenant data between machines.

Synopsis: 

uv run python sync_tenant_data.py export [--output DIR] [--tenants TENANT ...] [--dry-run] [--force]
uv run python sync_tenant_data.py import [--input DIR] [--tenants TENANT ...] [--dry-run] [--force] [--no-preserve-local]

Options (from --help excerpt): - export|import subcommands - --tenants TENANT [TENANT ...] - --dry-run - --force - --output DIR / --input DIR - --no-preserve-local (import only)

Import incremental behavior: - Default import reads manifest.json from the input directory and local state from mcp-data/.sync_tenant_import_manifest.json. - Tenants whose source_snapshot.signature already matches local import state are skipped before archive listing or extraction. - --tenants and --force are operator overrides; they import selected tenants even when local state matches. - If manifest.json is missing or invalid, import falls back to the old behavior: import all discovered *.7z archives. - Successful real imports update local import state atomically after each tenant succeeds. --dry-run never writes import state.

Use import --dry-run on source machines when you only need to verify what would change.

Actual output (incremental import dry run): 

Importing 1 tenant(s)...
  Incremental unchanged skip: True

[1/1] django
  Skipping unchanged tenant import