Server MCP per Ollama: collega strumenti, ricerca Web e modelli locali

Cosa significa davvero server MCP per Ollama

MCP, cioè Model Context Protocol, è un modo standard perché un'applicazione AI scopra e chiami strumenti esposti da un server. Uno strumento può cercare sul Web, leggere una cartella autorizzata o interrogare un database. Ollama è il runtime del modello: carica il modello e genera risposte, ma un modello locale non trasforma automaticamente Ollama in un host MCP.

Per questo la ricerca server MCP per Ollama può indicare architetture diverse. Può essere un server locale che parla con Ollama oppure un host MCP che usa un modello Ollama e si collega a un server di ricerca. Di norma è l'host a gestire scoperta, approvazione, esecuzione e ritorno del risultato al modello.

Confine tra host, client, server e modello

Un'architettura MCP tipica ha quattro ruoli. L'host è l'applicazione AI e crea una connessione client per ogni server. Il server MCP annuncia gli strumenti ed esegue le chiamate approvate. Ollama sta accanto a questa catena come endpoint locale di inferenza.

Il modello non riceve automaticamente un tunnel verso tutti gli strumenti. L'host presenta gli schemi, il modello può chiedere una chiamata e l'host valida gli argomenti prima di eseguire. Poi decide quanto risultato restituire al modello.

Preparare Ollama e un host compatibile con MCP

Per prima cosa verifica che un modello funzioni già con Ollama. Il daemon deve essere attivo, il modello installato e l'API locale raggiungibile prima di aggiungere MCP. Se una richiesta normale non funziona, MCP renderà soltanto più difficile la diagnosi.

Poi scegli un'applicazione che documenti il supporto ai client MCP. La configurazione può essere JSON, una schermata di impostazioni, un profilo desktop o un SDK. Non copiare configurazioni da un altro host senza controllare comando, trasporto, variabili d'ambiente e approvazioni predefinite.

ollama list

ollama run <model-name> "Rispondi solo pronto."

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

Collegare un modello Ollama locale in sicurezza

Prima di chiamare uno strumento verifica due connessioni. L'host deve raggiungere l'endpoint Ollama configurato: su desktop localhost è comune, mentre in un container possono servire host.docker.internal o un nome di servizio. Verifica anche che modello o API supportino il formato di tool calling atteso dall'host.

L'API Ollama può accettare definizioni di strumenti e restituire chiamate, ma questo non equivale automaticamente a un'implementazione completa di MCP. Un host MCP spesso traduce tra il messaggio del modello e i messaggi MCP per elencare o chiamare gli strumenti. Testa separatamente provider Ollama e connessione MCP.

curl http://127.0.0.1:11434/api/chat -H "Content-Type: application/json" -d "{\"model\":\"<model-name>\",\"messages\":[{\"role\":\"user\",\"content\":\"Controlla lo stato attuale di questo progetto.\"}],\"tools\":[] }"

Aggiungere la ricerca Web MCP senza inserire segreti nel codice

Un server MCP di ricerca Web è un fornitore di strumenti, non una garanzia che ogni risposta sia attuale o corretta. A seconda dell'implementazione può chiamare un'API, un browser, un metaricerca o un servizio ospitato. Leggi la documentazione ufficiale per trasporto, variabili, conservazione e runtime richiesto.

Molti host usano una forma simile all'esempio, ma i nomi delle chiavi cambiano. Consideralo un modello concettuale. Conserva le chiavi nel gestore dei segreti o nell'ambiente dell'host, limita gli strumenti e inizia con una ricerca in sola lettura.

1. Verificare la fonte

   Usa repository o documentazione ufficiale e controlla licenza, attività, runtime e trasporto.

2. Ridurre i permessi

   Consenti prima search o fetch, non scrittura di file, shell o accesso esteso alla rete privata.

3. Eseguire una query controllata

   Usa una query innocua e verifica nome dello strumento, argomenti e URL restituiti.

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

Rendere osservabili e verificabili le chiamate agli strumenti

Un flusso affidabile con un server MCP per Ollama lascia una traccia di audit utile senza registrare contenuti sensibili. Registra nome del server, nome dello strumento, ora di avvio, durata, esito, classe dell'errore e domini di origine. Oscura chiavi API, intestazioni di autorizzazione, contenuti di file privati e segreti dell’utente. Per la ricerca conserva gli URL finali e un breve conteggio dei risultati, così chi verifica può vedere quali prove ha ricevuto il modello.

Anche l’host deve rendere visibile l’approvazione. Un argomento generato dal modello è un input non attendibile. Prima dell’esecuzione valida URL, percorsi di file, lunghezza della query, elenchi di domini consentiti, timeout e numero massimo di risultati. Tratta le pagine recuperate come testo non attendibile: possono contenere istruzioni di prompt injection in conflitto con la richiesta dell’utente.

Diagnosticare il collegamento nell'ordine corretto

Prova un livello alla volta: Ollama senza MCP, poi elenco degli strumenti senza esecuzione e infine una chiamata a basso rischio. Così separi gli errori di modello, trasporto, permessi e provider.

Se il modello risponde dalla memoria senza chiamare uno strumento, controlla prima l'elenco del host e il supporto al tool calling. Se lo strumento funziona ma la risposta è debole, esamina risultato grezzo, fonti, troncamento del contesto e istruzioni inserite nelle pagine.

API Ollama Web Search e ricerca MCP

Ollama Web Search può indicare due percorsi. L'API ufficiale è un servizio ospitato con chiavi, limiti e confini di privacy propri. Un server MCP di ricerca Web è uno strumento chiamato da un host MCP; può essere locale, autogestito o basato su un altro provider. Entrambi possono fornire informazioni recenti, ma la configurazione è diversa.

Usa la guida esistente di Ollama Web Search per API ufficiale, web_fetch, privacy, limiti e SearXNG. Usa questa pagina per host MCP, schemi di strumenti, permessi e connessioni di client locali.