MCP-Server für Ollama: Tools, Websuche und lokale Modelle verbinden

Was ein MCP-Server für Ollama wirklich bedeutet

MCP, das Model Context Protocol, ist eine standardisierte Möglichkeit für eine KI-Anwendung, Tools eines Servers zu entdecken und aufzurufen. Ein Tool kann im Web suchen, einen erlaubten Ordner lesen oder eine Datenbank abfragen. Ollama ist die Laufzeit für das Modell: Es lädt ein Modell und erzeugt Antworten. Ein lokales Modell macht Ollama jedoch nicht automatisch zu einem MCP-Host.

Darum kann der Suchbegriff MCP-Server für Ollama verschiedene Architekturen meinen. Gemeint sein kann ein lokaler Server, der mit Ollama spricht, oder ein MCP-Host, der ein Ollama-Modell verwendet und einen Suchserver anbindet. Der Host übernimmt typischerweise Entdeckung, Freigabe, Ausführung und Rückgabe des Tool-Ergebnisses.

Grenze zwischen Host, Client, Server und Modell

Eine typische MCP-Architektur hat vier Rollen. Der Host ist die KI-Anwendung und erstellt pro Server eine MCP-Client-Verbindung. Der MCP-Server kündigt Tools an und führt genehmigte Aufrufe aus. Ollama steht daneben als lokaler Inferenz-Endpunkt, den der Host für Antworten oder Tool-Auswahl nutzt.

Das Modell erhält keinen automatischen Tunnel zu allen Tools. Der Host stellt die Tool-Schemata bereit, das Modell kann einen Aufruf anfordern, und der Host prüft und führt die Argumente aus. Anschließend entscheidet der Host, wie viel Ergebnis an das Modell zurückgegeben wird.

Ollama und einen MCP-fähigen Host vorbereiten

Prüfe zuerst, ob ein Modell mit Ollama bereits funktioniert. Der Dienst muss laufen, das Modell installiert sein und die lokale API antworten, bevor MCP hinzukommt. Wenn eine einfache Anfrage scheitert, wird MCP die Diagnose nur unübersichtlicher machen.

Wähle danach eine Anwendung, die MCP-Clients ausdrücklich unterstützt. Die Konfiguration kann aus JSON, einer Einstellungsseite, einem Desktop-Profil oder einem SDK bestehen. Übernimm keinen Block aus einem anderen Host, ohne Befehl, Transport, Umgebungsvariablen und Standardfreigaben zu prüfen.

ollama list

ollama run <model-name> "Antworte nur mit bereit."

curl http://127.0.0.1:11434/api/tags

Ein lokales Ollama-Modell sicher verbinden

Vor einem Tool-Aufruf müssen zwei Verbindungen funktionieren. Der Host muss den konfigurierten Ollama-Endpunkt erreichen: Auf dem Desktop ist localhost üblich, in einem Container können host.docker.internal oder ein Servicename nötig sein. Außerdem müssen Modell oder API die vom Host erwartete Tool-Calling-Form unterstützen.

Ollamas API kann Tool-Definitionen akzeptieren und Tool-Aufrufe zurückgeben. Das ist jedoch nicht automatisch eine vollständige MCP-Implementierung. Ein MCP-Host übersetzt häufig zwischen der Tool-Nachricht des Modells und MCP-Nachrichten zum Auflisten oder Aufrufen von Tools. Teste beide Verbindungen einzeln.

curl http://127.0.0.1:11434/api/chat -H "Content-Type: application/json" -d "{\"model\":\"<model-name>\",\"messages\":[{\"role\":\"user\",\"content\":\"Prüfe den aktuellen Status dieses Projekts.\"}],\"tools\":[] }"

Eine MCP-Websuche ohne fest codierte Geheimnisse hinzufügen

Ein MCP-Websuchserver ist ein Tool-Anbieter, keine Garantie für aktuelle oder korrekte Antworten. Je nach Implementierung ruft er eine Such-API, einen Browser, eine Metasuche oder einen gehosteten Anbieter auf. Lies die offizielle Dokumentation zu Transport, Umgebungsvariablen, Aufbewahrung und benötigter Laufzeit.

Viele Hosts verwenden eine ähnliche Form wie das Beispiel, aber die Schlüssel unterscheiden sich. Betrachte es als Muster, nicht als universellen Installationsbefehl. Bewahre API-Schlüssel im Secret Store oder in der Umgebung auf, begrenze die Tools und beginne mit einer schreibgeschützten Suche.

1. Quelle prüfen

   Nutze Repository oder Dokumentation des Anbieters und prüfe Lizenz, Aktivität, Laufzeit und Transport.

2. Berechtigungen minimieren

   Erlaube zuerst nur Suche oder Fetch, nicht Dateischreiben, Shell oder weitreichenden privaten Netzwerkzugriff.

3. Kontrolliert testen

   Verwende eine harmlose Anfrage und prüfe Toolname, Argumente und zurückgegebene URLs.

{ "mcpServers": { "web-search": { "command": "npx", "args": ["-y", "<mcp-websearch-paket>"], "env": { "SEARCH_API_KEY": "${SEARCH_API_KEY}" } } } }

Tool-Aufrufe beobachtbar und überprüfbar machen

Ein zuverlässiger Ollama-MCP-Server-Workflow hinterlässt einen Prüfpfad, der nützlich ist, ohne sensible Inhalte zu protokollieren. Erfasse den Servernamen, den Toolnamen, Startzeit, Dauer, Ergebnis, Fehlerklasse und Quelldomänen. Schwärze API-Schlüssel, Autorisierungsheader, private Dateiinhalte und Geheimnisse der Nutzer. Bewahre bei der Suche die endgültigen URLs und eine kurze Trefferzahl auf, damit ein Prüfer die Belege sehen kann, die das Modell erhalten hat.

Der Host sollte außerdem die Freigabe sichtbar machen. Ein vom Modell erzeugtes Argument ist nicht vertrauenswürdige Eingabe. Validiere vor der Ausführung URLs, Dateipfade, Abfragelänge, Domain-Allowlist, Zeitlimits und die maximale Trefferzahl. Behandle abgerufene Webseiten als nicht vertrauenswürdigen Text, weil sie Prompt-Injection-Anweisungen enthalten können, die der Nutzeranfrage widersprechen.

Die Verbindung in der richtigen Reihenfolge diagnostizieren

Teste jeweils eine Schicht: zuerst Ollama ohne MCP, dann die Tool-Liste ohne Ausführung und zuletzt einen risikoarmen Tool-Aufruf. So bleiben Modell-, Transport-, Berechtigungs- und Provider-Fehler getrennt.

Wenn das Modell aus dem Gedächtnis antwortet und kein Tool aufruft, prüfe zunächst die Tool-Liste des Hosts und die Tool-Calling-Unterstützung des Modells. Wenn das Tool läuft, aber die Antwort schlecht ist, untersuche Rohresultat, Quellen, Kontextkürzung und Anweisungen in abgerufenen Seiten.

Ollama Web Search API und MCP-Websuche

Ollama Web Search kann zwei Wege bezeichnen. Die offizielle API ist ein gehosteter Dienst mit eigenen Schlüsseln, Limits und Datenschutzgrenzen. Ein MCP-Websuchserver ist ein Tool, das ein MCP-Host aufruft; er kann lokal, selbst gehostet oder an einen anderen Anbieter angebunden sein. Beide Wege liefern aktuelle Informationen, aber die Einrichtung ist nicht gleich.

Für offizielle API, web_fetch, Datenschutz, Limits und SearXNG nutze den vorhandenen Ollama-Web-Search-Leitfaden. Diese Seite behandelt MCP-Hosts, Tool-Schemata, Berechtigungen und lokale Client-Verbindungen.