🚀 Gehostetes MCP jetzt verfügbar Wir freuen uns bekannt zu geben, dass ein gehostetes MCP jetzt verfügbar ist! Dies macht es einfacher denn je, Ihre externen Daten und APIs mit Ihrem bevorzugten KI-Tool zu verbinden – ohne Einrichtung oder Hosting.

👉 Erfahren Sie mehr und legen Sie los in unserer Dokumentation.

MCP

Dieses Repository enthält experimentelle Model Context Protocol (oder MCP)-Server für die Interaktion mit Algolia-APIs. Dieses MCP-Repo ist etwas, das wir zum Erkunden und Experimentieren mit Ihnen teilen. Fühlen Sie sich frei, es zu nutzen, zu forken oder darauf aufzubauen – aber seien Sie sich bewusst, dass es nicht offiziell von Algolia unterstützt wird und nicht unter unsere SLA fällt. Wir könnten es jederzeit aktualisieren, beschädigen oder vollständig entfernen. Wenn Sie hier Dinge anpassen oder konfigurieren, besteht die Möglichkeit, dass diese Arbeit verloren geht. Außerdem könnte die Verwendung von MCP in der Produktion Ihre Algolia-Nutzung beeinträchtigen.

Wir haben auch einen Node.js MCP-Server, den Sie hier finden: https://github.com/algolia/mcp-node.

Wenn Sie Feedback oder Ideen haben (sogar Code!), würden wir uns freuen, davon zu hören. Seien Sie sich nur bewusst, dass wir es möglicherweise nutzen, um unsere Produkte zu verbessern. Dieses Projekt wird "wie besehen" und "wie verfügbar" bereitgestellt, ohne Garantien oder Gewährleistungen. Um es ganz klar zu sagen: MCP gilt für SLA-Zwecke nicht als "API-Client".

Installation

Folgen Sie zuerst dem Schnellstart, der Claude Desktop installiert und einen Beispiel-Fileserver-MCP-Server einrichtet. Dies ist eine großartige Einführung in die Verwendung von MCP und ermöglicht es Ihnen, Dinge mithilfe des offiziellen Leitfadens zu debuggen, falls Probleme auftreten.

Related MCP server: crawleo-mcp

Einrichten des Prototyp-Algolia-MCP-Servers

Anforderungen:

• Go (https://go.dev/doc/install)

Klonen Sie das Repo und bauen Sie den Server

Klonen Sie das Repo und bauen Sie den MCP-Server:

$ git clone git@github.com:algolia/mcp.git
$ cd mcp/cmd/mcp
$ go build

Wir müssen den vollständigen Pfad der gebauten Server-Binärdatei haben:

$ pwd
/path/to/the/repo/cmd/mcp

HINWEIS: Wenn Sie diesen Befehl zu Ihrer Konfiguration hinzufügen, müssen Sie die Binärdatei zusammen mit dem Pfad angeben (/path/to/the/repo/cmd/mcp/mcp)

Aktualisieren Sie die Einstellungen, um auf den neuen Server zu verweisen

Bearbeiten Sie in Claude Desktop die Einstellungen gemäß https://modelcontextprotocol.io/quickstart/user#2-add-the-filesystem-mcp-server und fügen Sie diesmal die Serverdefinition für Algolia hinzu (unter Verwendung des Serverpfads, den Sie zuvor gefunden haben).

{
 "mcpServers": {
 "algolia": {
 "command": "/path/to/the/repo/cmd/mcp/mcp",
 "env": {
 "ALGOLIA_APP_ID": "<APP_ID>",
 "ALGOLIA_INDEX_NAME": "<INDEX_NAME>",
 "ALGOLIA_API_KEY": "<API_KEY>",
 "ALGOLIA_WRITE_API_KEY": "<ADMIN_API_KEY>", /* if you want to allow write operations, use your ADMIN key here */
 "MCP_ENABLED_TOOLS": "", /* optional: specify which tools to enable (e.g., "search,collections") */
 "MCP_SERVER_TYPE": "stdio", /* optional: server type, either "stdio" (default) or "sse". If not set, defaults to "stdio" */
 "MCP_SSE_PORT": "8080" /* optional: port for SSE server, default is 8080 (only used when MCP_SERVER_TYPE is "sse") */
 }
 }
 }
}

Standardmäßig sind alle verfügbaren Tools aktiviert, wenn MCP_ENABLED_TOOLS leer oder nicht gesetzt ist. Wenn Sie nur bestimmte Tools aktivieren möchten, können Sie diese Variable auf eine durch Kommas getrennte Liste von Toolnamen setzen. Verfügbare Tools sind: abtesting, analytics, collections, monitoring, querysuggestions, recommend, search, search_read, search_write, usage.

• search: Aktiviert alle Suchvorgänge (sowohl Lesen als auch Schreiben)

• search_read: Aktiviert nur Lesevorgänge (Indizes auflisten, Einstellungen abrufen, Abfragen ausführen, Objekte abrufen)

• search_write: Aktiviert nur Schreibvorgänge (löschen, kopieren, löschen, verschieben, Einstellungen festlegen, Objekte löschen, Objekte einfügen)

Starten Sie Claude Desktop neu, und Sie sollten sehen, dass ein neues "algolia"-Tool verfügbar ist.

Debugging

Sie können den Inspector ausführen (siehe https://modelcontextprotocol.io/docs/tools/inspector), um die MCP-Funktionen zu überprüfen und sie manuell auszuführen.

Richten Sie von der Repo-Wurzel aus die Umgebung ein

$ export ALGOLIA_APP_ID=""
$ export ALGOLIA_INDEX_NAME=""
$ export ALGOLIA_API_KEY=""
$ export ALGOLIA_WRITE_API_KEY="" # if you want to allow write operations, use your ADMIN key here
$ export MCP_ENABLED_TOOLS="" # if you want to restrict the tools activated you can optionally specify a list
$ export MCP_SERVER_TYPE="stdio" # optional: server type, either "stdio" (default) or "sse". If not set, defaults to "stdio"
$ export MCP_SSE_PORT="8080" # optional: port for SSE server, default is 8080 (only used when MCP_SERVER_TYPE is "sse")

Wechseln Sie in das Serververzeichnis und bauen Sie neu (falls erforderlich):

$ cd cmd/mcp
$ go build # might already be up-to-date

Führen Sie den MCP-Inspector auf dem Server aus:

$ npx @modelcontextprotocol/inspector ./mcp

Verwendung mit Ollama

Tatsächlich können Sie einen lokalen mcphost ausführen (der die MCP-Server für Sie orchestriert) und sie dann lokal mit anderen Modellen über Ollama verwenden.

Wir verwenden hierfür https://github.com/mark3labs/mcphost.

Gemäß der README benötigen Sie eine Konfigurationsdatei. Sie können also die von Claude kopieren und an einem sinnvollen Ort ablegen, damit Sie sie über die Befehlszeile verwenden können (zum Beispiel ~/mcp.json)

{
 "mcpServers": {
 "algolia": {
 "command": "/path/to/the/repo/cmd/mcp/mcp",
 "env": {
 "ALGOLIA_APP_ID": "<APP_ID>",
 "ALGOLIA_INDEX_NAME": "<INDEX_NAME>",
 "ALGOLIA_API_KEY": "<API_KEY>",
 "MCP_ENABLED_TOOLS": "", /* optional: specify which tools to enable (e.g., "search,collections") */
 "MCP_SERVER_TYPE": "stdio", /* optional: server type, either "stdio" (default) or "sse". If not set, defaults to "stdio" */
 "MCP_SSE_PORT": "8080" /* optional: port for SSE server, default is 8080 (only used when MCP_SERVER_TYPE is "sse") */
 }
 }
 }
}

Standardmäßig sind alle verfügbaren Tools aktiviert, wenn MCP_ENABLED_TOOLS leer oder nicht gesetzt ist. Wenn Sie nur bestimmte Tools aktivieren möchten, können Sie diese Variable auf eine durch Kommas getrennte Liste von Toolnamen setzen. Verfügbare Tools sind: abtesting, analytics, collections, monitoring, querysuggestions, recommend, search, search_read, search_write, usage. Sie können es jetzt direkt ausführen (kein Auschecken des Repos erforderlich):

$ go run github.com/mark3labs/mcphost@latest --config ~/mcp.json -m ollama:qwen2.5:3b

FAQ

Welche Dinge kann ich tun, sobald ich dieses MCP installiert habe?

Hier sind einige Beispiel-Prompts, um Ihre Fantasie anzuregen:

• „Suche alle Produkte im Index, bei denen brand = ‘Nike’ und price < 100 ist.“

• „Füge dieses JSON-Objekt zum blog_posts-Index hinzu.“

• „Aktualisiere die durchsuchbaren Attribute für den recipes-Index, um Zutaten einzuschließen.“

• „Konfiguriere meinen Index so, dass nebula_award-Gewinner höher eingestuft werden.“

Wo kann ich mehr über den Algolia-MCP-Server lesen?

Schauen Sie sich diesen Blogbeitrag an, der ein eingebettetes Demo-Video enthält.

Ressourcenvorlagen und Root werden derzeit nicht von Claude Desktop unterstützt

Dies ist eine seltsame Sache, da es eine Menge Inhalte online gibt, die die Vorlagen zeigen, vielleicht ist es einfach noch nicht allgemein verfügbar (GA).

Maintenance

Resources

• GitHub Repository
Need Help?Related Servers