Weaviate MCP Server

Der Weaviate MCP Server ist der offizielle Model-Context-Protocol-Endpunkt von Weaviate. Er ist kein separates Paket und kein inoffizieller Wrapper: Seit Weaviate 1.38 ist er im Weaviate-Datenbankserver eingebaut. Nach dem Aktivieren stellt derselbe REST-Port den Streamable-HTTP-Endpunkt /v1/mcp bereit. Ein MCP-fähiger Client kann damit laut Weaviate Collections und Mandanten prüfen, Hybrid-Suchen ausführen und – nur bei ausdrücklich erlaubtem Schreibzugriff – Objekte einfügen oder ersetzen. Der Eintrag bezieht sich auf diesen aktuellen, eingebauten Server. Das ältere Repository weaviate/mcp-server-weaviate beschreibt selbst eine eingestellte Standalone-Implementierung; der gepflegte Quellcode liegt im Hauptrepository weaviate/weaviate.

Vektordaten für Analyse und Coding

Weaviate speichert Objekte zusammen mit Vektoren und kann Vektorsuche mit BM25-Stichwortsuche, Filtern und Metadaten verbinden. Das MCP-Werkzeug weaviate-query-hybrid sucht innerhalb einer benannten Collection; der Parameter alpha gewichtet dabei Stichwort- und Vektorsuche. Ein Client kann Rückgabefelder, Metadaten, Filter, Ergebnislimit und Zielvektoren einschränken. Das ist für Datenanalyse passend, weil ein kontrollierter Bestand nach Bedeutung und Textbegriffen untersucht werden kann. Für Coding hilft es, Collection-Schema, Datentypen und Suchverhalten bei der Entwicklung oder beim Debugging nachvollziehbar zu prüfen.

Ein Treffer ist dennoch keine Quellenprüfung. Vektorähnlichkeit misst Nähe in der gewählten Repräsentation, nicht Wahrheit, Aktualität, Berechtigung zur Weitergabe oder fachliche Relevanz. Begrenze return_properties, damit nicht unabsichtlich vollständige Langtexte in den Chat-Kontext gelangen, und prüfe wichtige Ergebnisse gegen Originaldaten und Zugriffsregeln. Die Kategorien Datenanalyse und Coding sind gezielt gewählt: Der Server arbeitet mit Datenbeständen und technischen Schema- beziehungsweise Suchabläufen. Er ist weder ein allgemeines Recherchewerkzeug noch eine Garantie für korrekte Modellantworten.

Betrieb, Authentifizierung und Rechte

Bei selbst betriebenem Weaviate ist der MCP-Server aus Sicherheitsgründen standardmäßig deaktiviert. MCP_SERVER_ENABLED=true aktiviert ihn; standardmäßig bleibt der Zugriff auf Lesewerkzeuge beschränkt. Auf Weaviate Cloud ist der Endpunkt laut Dokumentation aktiv und wird über die Cluster-URL mit angehängtem /v1/mcp verbunden. Bei deaktiviertem anonymen Zugriff übermittelt der Client einen Bearer-Token beziehungsweise API-Key. Nutze keinen Root- oder breit gültigen Schlüssel für einen Agenten. Weaviate dokumentiert für lesende Szenarien die Viewer-Rolle mit MCP- und Datenleserechten; Rollen und Collection-Zugriff sollten auf den konkreten Zweck reduziert sein.

Der lokale oder selbst gehostete Datenbankprozess verarbeitet seine Datenbankoperationen in der eigenen Weaviate-Umgebung. Das bedeutet nicht automatisch, dass Inhalte den Rechner oder das eigene Netzwerk nie verlassen. Der MCP-Client erhält Schema- und Suchergebnisse und kann sie in einen Modellkontext, Logs, Telemetrie oder einen angebundenen Modellanbieter weiterreichen. Falls Weaviate bei Importen oder Upserts einen externen Vektorisierer verwendet, kann auch dieser Vektorisierer einen eigenen Datenpfad haben. Selbst bereitgestellte Vektoren und eine lokal betriebene Vektorisierung ändern diese Bewertung, ersetzen aber nicht die Prüfung des verbundenen Clients und Modells.

Schreibvorgänge, Schema und Prompt Injection

weaviate-objects-upsert ist nur sichtbar, wenn Schreibzugriff aktiviert ist. Ein Upsert ersetzt ein Objekt, statt fehlende Eigenschaften zusammenzuführen: Ausgelassene Eigenschaften können dadurch verloren gehen. Ohne mitgelieferte Vektoren kann Weaviate bei einer Collection mit Vektorisierer neu vektorisieren; ohne Vektorisierer kann ein gespeicherter Vektor entfallen. Bei aktivem Auto-Schema können unbekannte Eigenschaften das Schema erweitern, und ein falsch geschriebener Collection-Name kann eine neue Collection anlegen. Teste deshalb mit einer nicht produktiven Collection, deaktiviere Schreibzugriff für reine Analyse und bestätige Ziel, Collection, vollständiges Objekt und erwartete Wirkung unabhängig vom Agenten.

Datenfelder und Suchtreffer können Text enthalten, der versucht, ein Modell zu weiteren Tool-Aufrufen zu verleiten. Das ist Prompt Injection, nicht eine vertrauenswürdige Anweisung. Behandle Collection-Inhalte, Metadaten und benutzerdefinierte Werkzeugbeschreibungen als Daten; gib ihnen keine Priorität über Benutzer- oder Sicherheitsvorgaben. Begrenze Schreibrechte, prüfe Tool-Aufrufe im Client, verwende getrennte Test- und Produktions-Keys und speichere Bearer-Tokens nie in Prompts, Git, Screenshots oder geteilten Konfigurationsdateien. Das Hauptrepository steht unter BSD-3-Clause. Die GitHub-API meldete am 08.09.2026 exakt 16.793 Sterne für das gesamte Weaviate-Repository; das ist eine Momentaufnahme seiner Popularität, kein Qualitäts- oder Sicherheitsnachweis.

FAQ

Ist dies ein lokaler stdio-Server? Nein. Der aktuelle offizielle MCP-Server ist in Weaviate integriert und nutzt Streamable HTTP am REST-Endpunkt /v1/mcp. Selbst gehostetes Weaviate kann lokal oder im eigenen Netzwerk laufen; der Client verbindet sich per HTTP.

Kann eine Suche sensible Vektordaten offenlegen? Sie kann Eigenschaften und angeforderte Metadaten aus der berechtigten Collection an den MCP-Client liefern. Embeddings sind keine automatische Anonymisierung. Beschränke Rollen, Felder, Limits und den nachfolgenden Modellpfad.

Wie verhindere ich Änderungen? Bei selbst gehostetem Weaviate MCP_SERVER_WRITE_ACCESS_ENABLED nicht aktivieren. In Weaviate Cloud den clusterweiten Read-Only-Schalter verwenden oder dem Agenten einen Viewer-Key geben.

Weaviate ab Version 1.38, ein MCP-fähiger HTTP-Client sowie bei geschützter Instanz ein Bearer-Token oder API-Key mit minimalen MCP- und Collection-Rechten.

Bei selbst gehostetem Weaviate MCP_SERVER_ENABLED=true setzen, anschließend den Client mit http://<host>:8080/v1/mcp verbinden und einen minimal berechtigten Bearer-Token als Header übergeben. Schreibzugriff nur mit MCP_SERVER_WRITE_ACCESS_ENABLED=true und nach einem Test in einer nicht produktiven Collection aktivieren.

MCP_SERVER_ENABLED=true weaviate

Bei deaktiviertem anonymen Zugriff verwendet der Client einen Bearer-Token beziehungsweise API-Key. Mit RBAC sind zusätzlich die passenden MCP- und Collection-Rechte nötig; ein Viewer-Key eignet sich für Lesezugriff.

Berechtigungen werden in Weaviate durch API-Key, Rolle und Collection-Zugriff geprüft. Die Tool-Liste allein beweist keine Berechtigung; Schreibzugriff muss zusätzlich aktiviert sein.

Weaviate verarbeitet Objekte, Vektoren und Suchanfragen in der verbundenen Instanz. Ergebnisse gehen an den MCP-Client und können dort in Logs, Telemetrie oder an ein verbundenes Modell gelangen; externe Vektorisierer können einen zusätzlichen Datenpfad haben.

Breite Bearer-Tokens, schreibende Upserts, Auto-Schema, sensible Objekt- oder Vektordaten, Prompt Injection in Suchtreffern und die Weitergabe an den verbundenen Modellpfad erhöhen das Risiko.