README.md•2.12 kB
# Qdrant Sync MCP Server
A dedicated MCP server for bidirectional sync between local Qdrant and VPS.
## Overview
**Local:** localhost:6335 (73 collections)
**VPS:** 74.50.49.35:6333 (74 collections)
## Tools (9 total)
### Status & Comparison
| Tool | Description |
|------|-------------|
| `qdrant_sync_status` | Check connectivity to both instances |
| `qdrant_compare_collections` | Compare collection stats, identify differences |
### Local → VPS (Push)
| Tool | Description |
|------|-------------|
| `qdrant_sync_all` | Full sync all collections (requires confirm=true) |
| `qdrant_sync_collection` | Sync single collection by name |
| `qdrant_sync_dry_run` | Preview without syncing |
### VPS → Local (Pull)
| Tool | Description |
|------|-------------|
| `qdrant_sync_from_vps_all` | Pull all collections (requires confirm=true) |
| `qdrant_sync_from_vps_collection` | Pull single collection by name |
| `qdrant_sync_from_vps_dry_run` | Preview VPS state without syncing |
### Logs
| Tool | Description |
|------|-------------|
| `qdrant_sync_logs` | View recent sync logs |
## Installation
```bash
cd /home/vanya/3-Projects-Github/qdrant-sync-mcp
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
```
## Claude Desktop Config
```json
{
"qdrant-sync": {
"command": "/home/vanya/3-Projects-Github/qdrant-sync-mcp/venv/bin/python",
"args": ["/home/vanya/3-Projects-Github/qdrant-sync-mcp/server.py"],
"env": {
"QDRANT_SYNC_CONFIG": "/home/vanya/.config/qdrant-sync/config.env",
"QDRANT_SYNC_SCRIPT": "/home/vanya/scripts/sync-qdrant-to-vps.sh",
"QDRANT_SYNC_SCRIPT_REVERSE": "/home/vanya/scripts/sync-qdrant-from-vps.sh",
"QDRANT_SYNC_LOG_DIR": "/home/vanya/logs"
}
}
}
```
## Scripts
- `/home/vanya/scripts/sync-qdrant-to-vps.sh` - Local → VPS
- `/home/vanya/scripts/sync-qdrant-from-vps.sh` - VPS → Local
## Related Docs
`/home/vanya/hp-projects/3-Projects-Github/onesong-coachgrow-ebatt-shared-enhancement-and-alignment-project/04.docs/Qdrant-sync-system.md`
---
Created: November 23, 2025 | Author: Vanya + Claude