Searchcraft MCP Server

Der Searchcraft MCP Server ist der offizielle Model-Context-Protocol-Connector von Searchcraft Inc., einem US-amerikanischen Anbieter einer in Rust entwickelten, entwicklerorientierten Such-Engine. Laut offiziellem Repository unter https://github.com/searchcraft-inc/searchcraft-mcp-server (Apache-2.0-Lizenz, am 19.09.2026 per GitHub-API mit 9 Sternen erfasst, aktiv gepflegt, package.json-Version 0.2.0) verbindet der Server MCP-fähige Clients wie Claude Desktop oder Claude Code direkt mit einer laufenden Searchcraft-Instanz und erlaubt es, eine komplette Such-Engine allein über natürlichsprachige Anweisungen zu verwalten, statt Code zu schreiben oder Dashboards zu bedienen.

Was ist Searchcraft und wofür eignet sich der MCP-Server?

Searchcraft positioniert sich laut eigener Aussage als Alternative zu klassischen Suchlösungen wie Elasticsearch oder teuren Vektordatenbank-Setups: Statt ausschließlich auf semantische Vektorsuche zu setzen, kombiniert die Engine performante Keyword-Suche mit einer zusätzlichen "Semantic Control Layer". Zielgruppe sind laut Anbieter vor allem Entwicklerteams, die Produktsuche für B2B-SaaS-Anwendungen, durchsuchbare Dokumentation, Publishing-Plattformen oder Retrieval für generative KI- und Agenten-Workflows aufbauen. Der MCP-Server macht diese Funktionalität für KI-Coding-Assistenten nutzbar: Ein Agent kann im Auftrag der Entwicklerin oder des Entwicklers Indizes anlegen, Testdaten importieren, Suchanfragen ausführen und sogar eine fertige Suchoberfläche generieren, ohne dass jemand manuell die Searchcraft-API ansteuern muss.

Funktionen und Tools

Laut README stellt der Server über 50 Werkzeuge aus drei Kategorien bereit. Die "Engine API Tools" decken die komplette Verwaltung einer Searchcraft-Instanz ab: Indizes erstellen, konfigurieren und löschen, Dokumente hinzufügen, aktualisieren oder entfernen, Zugriffsschlüssel mit granularen Rechten erzeugen (Tool create_key), Synonyme und Stopwords pflegen sowie Suchanfragen ausführen und Analysedaten abrufen (get_search_results). Die "Import Tools" erleichtern den Einstieg: Mit create_index_from_json lässt sich aus einer JSON-Datei oder einer URL automatisch ein passendes Index-Schema ableiten und befüllen, ohne dass die Struktur der Daten vorher von Hand modelliert werden muss. Besonders auffällig ist die dritte Kategorie, die App-Generierung: Das Tool create_vite_app erzeugt aus den vorhandenen Indexdaten eine vollständige, eigenständige Such-Anwendung auf Basis von Vite und React, inklusive Lesezugriffsschlüssel – ein Agent kann damit in einem einzigen Arbeitsgang von "Rohdaten als JSON" zu einer lauffähigen, durchsuchbaren Web-Oberfläche kommen.

Betriebsarten und Voraussetzungen

Der Server selbst lässt sich auf mehreren Wegen betreiben: als stdio-Prozess für Claude Desktop und Claude Code (empfohlener Weg laut README), als lokaler HTTP-Server zum Testen oder als Docker-Container für Remote- beziehungsweise Serverbetrieb. In jedem Fall benötigt der Server aber eine bereits existierende Searchcraft-Instanz, auf die er zugreift: Die Umgebungsvariablen ENDPOINT_URL (Adresse des Searchcraft-Clusters) und CORE_API_KEY (API-Schlüssel) müssen gesetzt sein. Diese Instanz kann entweder eine verwaltete Searchcraft-Cloud-Umgebung (Vektron Dashboard) oder ein selbst gehosteter "Searchcraft Core"-Server sein. Node.js 22 oder neuer wird für Build und Betrieb vorausgesetzt.

Preismodell: kostenloser Connector, kostenpflichtige Engine

Der MCP-Server-Quellcode selbst ist unter Apache-2.0 lizenziert und damit frei nutzbar. Die zugrunde liegende Searchcraft-Suchmaschine ist laut Anbieter jedoch keine kostenlose Open-Source-Engine: Wörtlich heißt es in den offiziellen FAQ, "open-source software is free, running search itself is not". Für den produktiven Einsatz von Searchcraft Core im Eigenbetrieb ist laut Anbieter ein Lizenz- und Supportvertrag mit Searchcraft nötig; alternativ steht die verwaltete Searchcraft-Cloud-Lösung mit nutzungsbasierter Abrechnung zur Verfügung. Konkrete Beträge nennt die öffentliche Website nicht, Interessenten werden auf ein Kontaktformular für individuelle Angebote verwiesen. Wer den MCP-Server ausprobieren möchte, benötigt also in jedem Fall zunächst Zugangsdaten zu einer laufenden Searchcraft-Instanz.

Für wen lohnt sich der Searchcraft MCP Server?

Der Server eignet sich vor allem für Teams, die bereits mit Searchcraft arbeiten oder eine Suchlösung evaluieren und dabei KI-Coding-Assistenten in den Aufbau- und Wartungsprozess einbinden möchten – etwa um schnell Prototyp-Indizes aus vorhandenen JSON-Exporten zu erzeugen oder eine erste durchsuchbare Oberfläche zu demonstrieren. Wer lediglich eine kostenlose, quelloffene Such-Engine ohne Anbieterbindung sucht, findet im Skill-Road-Katalog mit dem Redis MCP Server oder Fetch MCP andere, dauerhaft kostenlose Alternativen für verwandte Datenzugriffs- und Recherche-Aufgaben.

FAQ

Ist der Searchcraft MCP Server kostenlos? Der Quellcode des Connectors ist Apache-2.0-lizenziert und kostenlos. Der Betrieb setzt aber eine Searchcraft-Instanz voraus, deren produktiver Einsatz laut Anbieter kostenpflichtig ist (Cloud-Abrechnung oder Self-Host-Lizenzvertrag).

Brauche ich einen Searchcraft-Account? Ja. Ohne ENDPOINT_URL und CORE_API_KEY einer laufenden Searchcraft-Cloud- oder Self-Hosted-Core-Instanz funktioniert der Server nicht.

Was macht create_vite_app? Das Tool generiert aus vorhandenen Indexdaten automatisch eine vollständige React-Anwendung mit Vite als Build-Tool, inklusive eines schreibgeschützten Lesezugriffsschlüssels für die neue Such-App.

Wie aktuell sind die GitHub-Sterne? Die GitHub-API meldete am 19.09.2026 exakt 9 Sterne für das Repository https://github.com/searchcraft-inc/searchcraft-mcp-server. Das ist eine Momentaufnahme und kein Qualitätsurteil.

Node.js 22 oder neuer; eine bereits existierende Searchcraft-Instanz (Cloud oder Self-Hosted Core) mit Endpunkt-URL und API-Schlüssel; MCP-fähiger Client mit Unterstützung für lokale stdio-Server.

Repository klonen, mit yarn installieren und yarn build ausführen. .env-Datei mit ENDPOINT_URL und CORE_API_KEY der eigenen Searchcraft-Instanz anlegen. Für Claude Code: claude mcp add searchcraft -- node /pfad/zu/dist/stdio-server.js. Alternativ Docker-Image bauen und mit denselben Umgebungsvariablen starten.

claude mcp add searchcraft -- node /path/to/dist/stdio-server.js

API-Schlüssel-Authentifizierung gegenüber der eigenen Searchcraft-Instanz über die Umgebungsvariable CORE_API_KEY; Schlüssel können mit dem Tool create_key mit granularen Rechten erzeugt werden.

Voller Lese- und Schreibzugriff auf die konfigurierte Searchcraft-Instanz entsprechend den Rechten des verwendeten API-Schlüssels: Indizes und Dokumente anlegen, ändern, löschen sowie Suchanfragen und Analysen ausführen.

Anfragen laufen vom lokal betriebenen MCP-Server direkt an die konfigurierte ENDPOINT_URL der eigenen Searchcraft-Cloud- oder Self-Hosted-Core-Instanz. Es fließen keine Daten über von Searchcraft zusätzlich betriebene Drittserver, abgesehen vom gewählten Cloud-Cluster selbst.

Der API-Schlüssel gewährt je nach Konfiguration weitreichende Schreibrechte auf die Searchcraft-Instanz (Indizes anlegen/löschen, Dokumente ändern); Schlüssel sollten daher mit möglichst engen, granularen Rechten erzeugt und nicht im Klartext geteilt werden. Da der Server lokal läuft, bestehen keine zusätzlichen Risiken durch einen von Dritten gehosteten Vermittlungsdienst.