Meilisearch MCP Server

Der Meilisearch MCP Server verbindet KI-Assistenten mit einer laufenden Meilisearch-Instanz. Wer Meilisearch für die Suche in einem Onlineshop, einer Dokumentation oder einer Anwendung einsetzt, kann damit im Gespräch Indizes anlegen, Dokumente hinzufügen, Suchanfragen testen, Relevanz-Einstellungen anpassen und den Zustand des Systems prüfen, ohne dafür curl-Befehle oder das Dashboard zu bemühen. Laut README arbeitet der Server mit dem Stdio-Transport, ist in Python geschrieben und basiert auf dem offiziellen MCP-Python-SDK. Er steht unter der MIT-Lizenz und wird im GitHub-Repository der Organisation meilisearch geführt; das Repository ist nicht archiviert und wurde zuletzt im September 2026 aktualisiert.

Was ist der Meilisearch MCP Server?

Meilisearch ist eine quelloffene Suchmaschine, die sich besonders durch schnelle, fehlertolerante Suche auszeichnet. Der MCP-Server ist ein kleines Zwischenstück: Er läuft lokal auf Ihrem Rechner, spricht über die Meilisearch-HTTP-API mit Ihrer Instanz und stellt dem Assistenten deren Funktionen als Werkzeuge zur Verfügung. Insgesamt nennt die README 22 Werkzeuge. Sie decken die Verbindung, Indizes, Dokumente, die Suche, Einstellungen, API-Schlüssel, Aufgaben (Tasks) und die Systemüberwachung ab. Zu jedem datenliefernden Werkzeug gibt der Server laut README neben dem Text auch strukturierte Ausgaben zurück, was Clients die Weiterverarbeitung erleichtert.

Was kann der Assistent damit tun?

Für die tägliche Arbeit sind vor allem drei Bereiche nützlich. Erstens die Datenpflege: Mit create-index, add-documents und get-documents lassen sich Testindizes aufbauen und kontrollieren, etwa um einen Produktkatalog auszuprobieren. Zweitens die Suche selbst: Das Werkzeug search durchsucht einen oder mehrere Indizes mit Filtern und Sortierung, sodass Sie Ranking-Fragen direkt im Chat klären können. Drittens die Einstellungen: Mit get-settings und update-settings lassen sich Ranking-Regeln und Facetten ansehen und anpassen. Hinzu kommen get-index-metrics, get-stats, get-version, health-check und get-health-status für einen schnellen Überblick sowie get-tasks und cancel-tasks, um Hintergrundaufgaben der Instanz zu beobachten oder zu stoppen.

Besonderheiten: dynamische Verbindung und API-Schlüssel

Eine Eigenheit ist der Wechsel der Verbindung während des Gesprächs. Über get-connection-settings und update-connection-settings kann der Assistent die Adresse und den Schlüssel ändern und so zwischen einer lokalen Entwicklungsinstanz und einer Testinstanz wechseln. Außerdem lassen sich API-Schlüssel mit get-keys, create-key und delete-key verwalten. Die README weist selbst darauf hin, dass dieses Hinzufügen von Hosts und Schlüsseln im Chat in erster Linie für die Entwicklung gedacht ist, nicht den Best Practices für MCP-Sicherheit entspricht und ohne zusätzliche Schutzmaßnahmen nicht in der Produktion verwendet werden sollte.

Einrichtung

Sie brauchen Python 3.10 oder neuer, eine laufende Meilisearch-Instanz und einen MCP-fähigen Client. Die README empfiehlt den Start per uvx -n meilisearch-mcp; alternativ gibt es pip install meilisearch-mcp und ein Docker-Image (getmeili/meilisearch-mcp). Die Zieladresse und der Schlüssel werden über die Umgebungsvariablen MEILI_HTTP_ADDR (Standard: http://localhost:7700) und MEILI_MASTER_KEY gesetzt, wobei der Schlüssel optional ist. In Claude Desktop tragen Sie den Server in der Konfigurationsdatei ein; in Claude Code genügt ein einziger Befehl.

Sicherheit und Grenzen

Der Server kann nicht nur lesen, sondern auch schreiben: Er legt Indizes an, löscht sie samt allen Dokumenten (delete-index) und erzeugt oder entfernt Schlüssel. Das macht ihn mächtig und verlangt Sorgfalt. Verwenden Sie für Experimente einen Schlüssel mit eng gefassten Rechten statt des Master-Keys, und zeigen Sie dem Assistenten nie eine Produktivinstanz, deren Daten Sie nicht ersetzen können. Dokumente und Suchergebnisse, die der Assistent abruft, gelangen außerdem in den Kontext des Sprachmodells und damit zum Modellanbieter.

Kosten

Der MCP-Server selbst ist kostenlos und quelloffen. Meilisearch ist laut Anbieter ebenfalls quelloffen unter der MIT-Lizenz und lässt sich ohne Lizenzgebühr selbst betreiben; dann kümmern Sie sich um Updates, Backups und Skalierung. Wer lieber einen gehosteten Dienst nutzt, findet bei Meilisearch Cloud kostenpflichtige Pläne mit nutzungs- oder ressourcenbasierter Abrechnung und einen kostenlosen Testzeitraum, dazu einen Enterprise-Tarif auf Anfrage. Aktuelle Konditionen stehen auf der offiziellen Preisseite.

Für wen lohnt sich der Meilisearch MCP Server?

Er lohnt sich für Entwicklerinnen und Entwickler, die Meilisearch bereits einsetzen oder evaluieren: zum schnellen Aufbau von Testindizes, zum Ausprobieren von Ranking-Einstellungen und zum Beantworten von Fragen wie „Warum taucht dieses Produkt nicht oben auf?“. Auch für Teams, die einen Coding-Agenten Suchfunktionen in eine Anwendung einbauen lassen, ist ein Zugriff auf eine echte Entwicklungsinstanz hilfreich, weil der Agent Ergebnisse sofort prüfen kann. Wer Meilisearch nicht nutzt, hat davon keinen Nutzen, und für den unbeaufsichtigten Produktivbetrieb ist der Server laut README nicht gedacht.

Python 3.10 oder neuer (oder Docker), eine laufende Meilisearch-Instanz und ein MCP-fähiger Client; ein API-Schlüssel ist optional, wird aber für geschützte Instanzen gebraucht.

Der Meilisearch MCP Server läuft lokal und steuert eine Meilisearch-Instanz über deren HTTP-API. Dieser Ratgeber führt durch die Einrichtung.

Schritt 1: Voraussetzungen

Sie brauchen Python 3.10 oder neuer (für uvx), eine laufende Meilisearch-Instanz und einen MCP-fähigen Client. Eine lokale Instanz starten Sie laut README zum Beispiel per Docker mit dem Image getmeili/meilisearch auf Port 7700.

Schritt 2: Schlüssel eng fassen

Legen Sie für den Assistenten einen eigenen API-Schlüssel mit den nötigen Rechten an, statt den Master-Key zu verwenden. Der Server kann Indizes löschen und Schlüssel verwalten, daher begrenzt der Schlüssel den möglichen Schaden.

Schritt 3: Server in Claude Code eintragen

Führen Sie claude mcp add meilisearch -e MEILI_HTTP_ADDR=http://localhost:7700 -e MEILI_MASTER_KEY=IHR_SCHLUESSEL -- uvx -n meilisearch-mcp aus. Ohne Schlüssel lassen Sie die zweite Variable weg. Prüfen Sie danach mit /mcp, ob der Server verbunden ist.

claude mcp add meilisearch -e MEILI_HTTP_ADDR=http://localhost:7700 -e MEILI_MASTER_KEY=IHR_SCHLUESSEL -- uvx -n meilisearch-mcp

Schritt 4: Server in Claude Desktop eintragen

Ergänzen Sie in claude_desktop_config.json unter mcpServers einen Eintrag meilisearch mit dem Befehl uvx und den Argumenten -n und meilisearch-mcp. Setzen Sie bei Bedarf einen env-Block mit den beiden Variablen und starten Sie den Client neu.

Alternative: Docker

Statt uvx können Sie das Image getmeili/meilisearch-mcp verwenden und MEILI_HTTP_ADDR sowie MEILI_MASTER_KEY als Umgebungsvariablen übergeben. Liegt Meilisearch auf dem Host, muss die Adresse aus dem Container erreichbar sein.

Schritt 5: Erste Anfragen

Bitten Sie den Assistenten, die Version und den Gesundheitszustand der Instanz abzufragen, danach einen Testindex anzulegen und einige Dokumente hinzuzufügen. Stellen Sie anschließend Suchanfragen mit Filtern und prüfen Sie über die Aufgabenliste, ob das Indizieren abgeschlossen ist.

Nicht für die Produktion

Die README warnt, dass das Wechseln von Hosts und Schlüsseln im Chat für die Entwicklung gedacht ist. Verbinden Sie den Assistenten nicht mit einer Produktivinstanz, deren Daten Sie nicht ersetzen können.

Über den optionalen Schlüssel MEILI_MASTER_KEY (oder einen eng gefassten API-Schlüssel) der Meilisearch-Instanz; der Server selbst hat keine eigene Anmeldung.

Lesender und schreibender Zugriff auf die verbundene Instanz im Umfang des verwendeten Schlüssels: Indizes, Dokumente, Einstellungen, Aufgaben und API-Schlüssel können angelegt, geändert und gelöscht werden.

Der Server läuft lokal und spricht nur mit der konfigurierten Meilisearch-Instanz. Abgerufene Dokumente und Suchergebnisse gelangen in den Kontext des KI-Clients und damit zum Modellanbieter.

Versehentliches Löschen von Indizes samt Dokumenten, Verwendung des Master-Keys statt eines eng gefassten Schlüssels, Wechsel der Verbindung im Chat auf eine Produktivinstanz und das Anlegen oder Entfernen von API-Schlüsseln durch den Assistenten.