ickyMCP

RAG MCP-Server für semantische Dokumentensuche. Er indiziert lokale Dokumentsammlungen in SQLite mit sqlite-vec und stellt dann MCP-Tools zum Indizieren, Suchen, Aktualisieren, Auflisten und Löschen indizierter Dokumente bereit.

Funktionen

• Semantische Suche über PDF-, Word-, PowerPoint-, Excel-, Markdown- und Textdateien

• Benutzerbezogene Datenbankisolierung mit optionalem Legacy-Modus für eine einzelne Datenbank

• Dokument-ID-Filter für Chat- oder fallbezogenes Abrufen

• Inkrementelle Indizierung basierend auf Dateigröße und Änderungszeitpunkt

• Voyage AI-Embeddings standardmäßig, mit einem offline verfügbaren lokalen sentence-transformers-Backend

• Portabler SQLite-Speicher mit ignorierten lokalen Datenbank-Artefakten

Related MCP server: MCP-RAGNAR

Einrichtung

python -m venv .venv
.\.venv\Scripts\activate
pip install -r requirements.txt

Erstellen Sie lokale Umgebungseinstellungen aus dem Beispiel:

copy .env.example .env

Setzen Sie ICKY_VOYAGE_API_KEY, wenn Sie das standardmäßige Voyage-Backend verwenden. Für die Offline-Nutzung setzen Sie ICKY_EMBEDDING_PROVIDER=local.

Konfiguration

Claude MCP-Konfiguration

{
  "mcpServers": {
    "ickyMCP": {
      "command": "python",
      "args": ["C:\\Users\\devan\\OneDrive\\Desktop\\Projects\\ickyMCP\\run.py"],
      "env": {
        "ICKY_EMBEDDING_PROVIDER": "voyage",
        "ICKY_VOYAGE_API_KEY": "YOUR_VOYAGE_API_KEY",
        "ICKY_CHUNK_SIZE": "5000",
        "ICKY_CHUNK_OVERLAP": "500"
      }
    }
  }
}

Tools

• index: Indiziert eine Datei oder ein Verzeichnis; akzeptiert user_id, patterns, exclude und force

• search: Semantische Abfrage über indizierte Chunks; akzeptiert document_ids, path_filter und file_types

• similar: Findet Chunks, die dem bereitgestellten Text ähnlich sind

• refresh: Indiziert geänderte Dateien neu und entfernt gelöschte Dateien aus dem Index

• list: Listet indizierte Dokumente und deren IDs auf

• delete: Löscht nach Pfad, Dokument-IDs oder alle Dokumente

• status: Gibt den Status von Datenbank, Embedding und Chunking zurück

Überprüfung

python -m compileall -q src run.py fast_index.py
python -c "from src.config import EMBEDDING_PROVIDER; print(EMBEDDING_PROVIDER)"

Die test_*.py-Dateien im Stammverzeichnis sind Integrationsskripte, die lokale Dokumente unter docs/ und für das Standard-Backend einen konfigurierten Voyage-API-Schlüssel erwarten.

Datenhygiene

Generierte Datenbanken und lokale Dokumentenordner werden von git ignoriert: *.db, *.db.bak, *.sqlite, *.sqlite3, data/ und docs/. Bewahren Sie echte API-Schlüssel in Umgebungsvariablen oder .env-Dateien auf, nicht in versionierten Dateien.

Lizenz

MIT