mcp-ollama

Servidor MCP que envuelve modelos locales de Ollama para descargar tareas de orquestadores con precios basados en API.

Expone nueve herramientas que envían trabajo a un modelo local (generación de texto, resumen, tareas de código, transformaciones mecánicas, redacción de commits/PR/changelogs). El orquestador decide qué enrutar localmente; este servidor realiza el enrutamiento.

• Transporte: stdio

• Runtime: Node 18+

• Modelo predeterminado: hermes3:8b (se puede sobrescribir mediante OLLAMA_MODEL)

• Host de Ollama: http://localhost:11434 (se puede sobrescribir mediante OLLAMA_HOST)

• No incluye pesos de modelos, no realiza llamadas a la nube, no tiene telemetría. Cada solicitud permanece en el host donde se ejecuta Ollama.

• Licencia: Apache-2.0

Por qué

Los orquestadores con precios por token (Claude Code, Cursor, la API de Anthropic, Cline, Aider) cobran por cada clasificación, cada docstring, cada mensaje de commit. La mayor parte de ese trabajo no necesita un modelo de frontera. Al enrutarse a Ollama en la misma máquina, el mismo trabajo es gratuito y más rápido. mcp-ollama es la superficie de enrutamiento.

El modelo orquestador decide qué enrutar y a dónde. Este servidor es infraestructura: no intenta ser inteligente sobre la clasificación de tareas. Elige la herramienta correcta, pasa el texto y obtén un resultado.

Related MCP server: ProjectBrain

Instalación

Desde el código fuente

git clone https://github.com/true-alter/mcp-ollama.git
cd mcp-ollama
npm install
npm run build

También necesitas una instancia de Ollama en ejecución con al menos un modelo descargado:

# Default — 8B, fast, good for classifications and short generations
ollama pull hermes3:8b

# Optional — code-specialised, heavier, better for local_code tasks
ollama pull qwen2.5-coder:32b

Docker

docker build -t mcp-ollama .
docker run -i --rm \
  -e OLLAMA_HOST=http://host.docker.internal:11434 \
  -e OLLAMA_MODEL=hermes3:8b \
  mcp-ollama

El Dockerfile suministrado apunta a host.docker.internal:11434 para que el contenedor alcance a Ollama en el host.

Ejecución (stdio)

node dist/index.js

Los servidores stdio son iniciados por el cliente MCP (Claude Code, Cursor, etc.); ejecutarlo directamente solo es útil para depuración.

Configurar Claude Code

claude mcp add --transport stdio ollama -- node /absolute/path/to/mcp-ollama/dist/index.js

O en ~/.claude/settings.json:

{
  "mcpServers": {
    "ollama": {
      "transport": "stdio",
      "command": "node",
      "args": ["/absolute/path/to/mcp-ollama/dist/index.js"],
      "env": {
        "OLLAMA_HOST": "http://localhost:11434",
        "OLLAMA_MODEL": "hermes3:8b"
      }
    }
  }
}

Herramientas

Los esquemas completos de las herramientas se exponen mediante introspección MCP; cualquier cliente compatible con MCP los enumerará automáticamente.

Variables de entorno

Cualquier llamada a herramienta puede sobrescribir model explícitamente; el valor predeterminado del entorno solo se aplica cuando no está configurado. local_code tiende a funcionar mejor con un modelo especializado en código pasado por llamada, mientras que local_summarize y local_draft funcionan bien con el predeterminado.

Guía de selección de modelos

Usa local_models al inicio de la sesión si no estás seguro de qué hay disponible en un host.

Solución de problemas

Ollama error 404 al llamar a una herramienta. El modelo no está descargado. Ejecuta ollama pull <nombre> o llama a local_pull desde el cliente.

fetch failed / conexión rechazada. Ollama no se está ejecutando, o OLLAMA_HOST apunta a un lugar incorrecto. Verifica con curl $OLLAMA_HOST/api/tags. Dentro de un contenedor, localhost es el propio contenedor; usa host.docker.internal en macOS/Windows o una IP de puente en Linux.

Las llamadas a herramientas se sienten lentas. La primera llamada a un modelo "frío" conlleva una carga. Las llamadas posteriores dentro del mismo proceso de Ollama son mucho más rápidas. Si el modelo es más grande que la VRAM disponible, Ollama recurre a la CPU; observa ollama ps para confirmar.

Salida vacía o truncada. max_tokens tiene un valor predeterminado de 2048 por herramienta. Para generaciones largas, pasa max_tokens explícitamente en la llamada a la herramienta.

Postura de seguridad

mcp-ollama no realiza ninguna llamada de red propia más allá del OLLAMA_HOST configurado. No incluye telemetría, ni analíticas, ni pings de actualización automática. Las entradas de las herramientas se reenvían al API HTTP de Ollama textualmente y la respuesta se retransmite; el servidor en sí no tiene estado entre llamadas.

Si ejecutas Ollama en localhost (el valor predeterminado), todo el bucle permanece en el host. Si apuntas OLLAMA_HOST a un endpoint remoto, trata la postura de seguridad de ese endpoint como autoritaria; un error tipográfico que envíe prompts a un host de terceros es trivialmente posible.

Para informar de un problema de seguridad, consulta SECURITY.md.

Contribuciones

Los informes de errores y pequeños parches son bienvenidos; consulta CONTRIBUTING.md. Cambios de diseño más grandes: por favor, abre un issue primero para que podamos hablar sobre el alcance antes de que inviertas tiempo.

Parte de ALTER

mcp-ollama es mantenido por ALTER como parte de la infraestructura de identidad para la economía de la IA. El servidor MCP de identidad de ALTER se aloja en mcp.truealter.com; consulta @truealter/sdk para el cliente de TypeScript.

Licencia

Apache License 2.0. Consulta LICENSE para el texto completo. Copyright 2026 Alter Meridian Pty Ltd (ABN 54 696 662 049).