Servidor MCP de Ollama: conecta herramientas, búsqueda web y modelos locales

Qué significa realmente un servidor MCP de Ollama

MCP, o Model Context Protocol, es una forma estándar para que una aplicación de IA descubra y llame herramientas expuestas por un servidor. Una herramienta puede buscar en la web, leer una carpeta permitida, consultar una base de datos o realizar una acción. Ollama es el runtime del modelo: carga un modelo y genera respuestas, pero el hecho de que el modelo sea local no convierte automáticamente a Ollama en un host MCP.

Por eso la búsqueda servidor MCP de Ollama puede describir arquitecturas distintas. Puede significar un servidor local que habla con Ollama o un host MCP que usa un modelo de Ollama y se conecta a un servidor de búsqueda. El host suele ser quien decide cuándo llamar una herramienta, pide aprobación, ejecuta la llamada y devuelve el resultado al modelo.

Límite entre host, cliente, servidor y modelo

En una arquitectura MCP típica hay cuatro piezas. El host es la aplicación de IA que usa la persona y crea un cliente MCP por cada servidor. El servidor anuncia herramientas y ejecuta una llamada aprobada. Ollama está junto a esa cadena como endpoint local de inferencia que el host utiliza para responder o decidir una llamada.

El modelo no obtiene un túnel automático hacia todas las herramientas. El host presenta los esquemas disponibles, el modelo puede solicitar una llamada, y el host valida y ejecuta los argumentos. Después decide qué parte del resultado vuelve al modelo. Este control es importante para privacidad, inyección de instrucciones, costes y depuración.

Preparar Ollama y un host compatible con MCP

Primero confirma que un modelo ya funciona con Ollama. Comprueba que el daemon está activo, que el modelo está instalado y que la API local responde antes de añadir MCP. Si una petición normal falla, el protocolo solo hará más difícil encontrar la causa.

Después elige una aplicación que documente explícitamente el soporte para clientes MCP. El formato puede ser un JSON, una pantalla de ajustes, un perfil de escritorio o un SDK. No copies una configuración de otro host: el comando, el transporte, las variables de entorno y los permisos pueden cambiar.

ollama list

ollama run <model-name> "Responde con la palabra listo."

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

Conectar un modelo local de Ollama

Antes de ejecutar una herramienta verifica dos cosas. Primero, que el host pueda llegar al endpoint de Ollama que tiene configurado. Un host de escritorio puede usar localhost; un contenedor puede necesitar host.docker.internal o un nombre de servicio. Segundo, confirma que el modelo o la ruta de API admiten llamadas a herramientas en el formato que espera el host.

La API de Ollama puede aceptar definiciones de herramientas y devolver llamadas, pero esa capacidad no equivale por sí sola a implementar todo el protocolo MCP. Un host compatible suele traducir entre el mensaje de llamada del modelo y los mensajes MCP de listar o llamar herramientas. Prueba el proveedor de Ollama y la conexión MCP por separado.

curl http://127.0.0.1:11434/api/chat -H "Content-Type: application/json" -d "{\"model\":\"<model-name>\",\"messages\":[{\"role\":\"user\",\"content\":\"Comprueba el estado actual de este proyecto.\"}],\"tools\":[] }"

Añadir un servidor MCP de búsqueda web sin exponer secretos

Un servidor MCP de búsqueda web es un proveedor de herramientas, no una garantía de que cada respuesta sea actual o correcta. Según su implementación puede llamar una API, un navegador, un metabuscador o un proveedor alojado. Revisa su documentación oficial, transporte, variables de entorno, retención y versión antes de usarlo.

Muchos hosts usan una forma parecida al ejemplo, pero los nombres exactos cambian. Trátalo como un patrón, no como un comando de instalación universal. Guarda las claves en el almacén de secretos o en el entorno del host, limita las herramientas y empieza con una búsqueda de solo lectura.

1. Verificar la fuente

   Usa el repositorio o documentación oficial del servidor y revisa licencia, actividad, runtime y transporte.

2. Empezar con pocos permisos

   Expón búsqueda o fetch antes de conceder escritura de archivos, shell o acceso amplio a la red privada.

3. Ejecutar una consulta controlada

   Usa una consulta inocua y verifica el nombre de la herramienta, los argumentos y las URL devueltas.

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

Hacer visibles y revisables las llamadas a herramientas

Un flujo fiable de servidor MCP para Ollama deja un registro de auditoría útil sin registrar contenido sensible. Registra el nombre del servidor, la herramienta, la hora de inicio, la duración, el resultado, el tipo de fallo y los dominios de origen. Redacta las claves API, las cabeceras de autorización, el contenido de archivos privados y los secretos del usuario. En las búsquedas, conserva las URL finales y un recuento breve de resultados para que un revisor pueda ver qué evidencias recibió el modelo.

El host también debe mostrar la aprobación. Un argumento generado por el modelo es una entrada no confiable. Valida las URL, las rutas de archivo, la longitud de la consulta, las listas permitidas de dominios, los tiempos de espera y el número máximo de resultados antes de ejecutar. Trata las páginas web obtenidas como texto no confiable porque pueden contener instrucciones de inyección de prompts que contradicen la solicitud del usuario.

Solucionar problemas en el orden correcto

Prueba una capa cada vez: primero Ollama sin MCP, luego la lista de herramientas sin ejecutarlas y por último una llamada de bajo riesgo. Así no mezclas un fallo de modelo, transporte, permisos y proveedor en un único mensaje genérico.

Si el modelo responde de memoria en lugar de llamar una herramienta, revisa la lista del host y el soporte de tool calling antes de cambiar el prompt. Si la herramienta funciona pero la respuesta es mala, inspecciona el resultado bruto, las fuentes, el recorte de contexto y las instrucciones de la página. No soluciones un error de permisos concediendo acceso ilimitado.

API Ollama Web Search frente a búsqueda MCP

Ollama Web Search puede referirse a dos caminos. La API oficial es un servicio alojado con credenciales, límites y privacidad propios. Un servidor MCP de búsqueda es una herramienta gestionada por un host MCP; puede ser local, autoalojada o usar otro proveedor. Ambos pueden aportar información reciente, pero no se configuran igual.

Usa la guía existente de Ollama Web Search para la API oficial, web_fetch, límites, privacidad y SearXNG. Usa esta página para hosts MCP, esquemas de herramientas, permisos, conexiones locales y servidores de búsqueda que son solo una capacidad entre varias.