mcp-nixos MCP — Casos de uso, Instalar & Demo en vivo

Por qué usarlo

Características clave

130k+ paquetes de NixOS + 23k+ opciones del sistema consultables
Cubre Home Manager (5k+ opciones), nix-darwin (1k+ configuraciones de macOS), Nixvim, FlakeHub, Noogle
Herramienta nix_versions para versiones históricas + hashes de commit de nixpkgs fijados
Sin autenticación requerida — solo consultas a API públicas
Se ejecuta a través de uvx, Nix flake o Docker

Demo en vivo

Cómo se ve en la práctica

nixos.replay ▶ listo

0/0

Instalar

Elige tu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "nixos": {
      "command": "uvx",
      "args": [
        "mcp-nixos"
      ],
      "_inferred": true
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "nixos": {
      "command": "uvx",
      "args": [
        "mcp-nixos"
      ],
      "_inferred": true
    }
  }
}

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "nixos": {
      "command": "uvx",
      "args": [
        "mcp-nixos"
      ],
      "_inferred": true
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "nixos": {
      "command": "uvx",
      "args": [
        "mcp-nixos"
      ],
      "_inferred": true
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "nixos",
      "command": "uvx",
      "args": [
        "mcp-nixos"
      ]
    }
  ]
}

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json

{
  "context_servers": {
    "nixos": {
      "command": {
        "path": "uvx",
        "args": [
          "mcp-nixos"
        ]
      }
    }
  }
}

Añádelo a context_servers. Zed recarga en caliente al guardar.

claude mcp add nixos -- uvx mcp-nixos

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: mcp-nixos

Busca un paquete de NixOS por nombre aproximado o propósito

👤 Usuarios de NixOS, autores de flakes ⏱ ~5 min beginner

Cuándo usarlo: Recuerdas aproximadamente qué hace el paquete pero no su nombre de atributo nix.

Flujo

Búsqueda

Busca paquetes de NixOS que coincidan con 'herramienta OCR de línea de comandos'.✓ Copiado

→ Lista ordenada de candidatos con descripciones
Obtén detalles del mejor candidato

Para tesseract, muestra la ruta de atributo, versión en unstable vs 24.11, y qué meta.platforms se soportan.✓ Copiado

→ Tarjeta de detalles con attr, versiones, plataformas

Resultado: El atributo exacto para poner en tu configuration.nix o flake.

Errores comunes

Desajuste de canal — el paquete solo existe en unstable, no en tu canal estable — Pregunta explícitamente sobre el canal que usas

Combinar con: filesystem

Busca una opción de módulo de NixOS con su tipo y valor por defecto

👤 Personas escribiendo módulos de NixOS ⏱ ~5 min beginner

Cuándo usarlo: Sabes que hay una opción 'en algún lugar' para habilitar zswap y no quieres buscar en nixpkgs.

Flujo

Consulta opciones

¿Existe una opción de NixOS para habilitar zswap? Muestra su tipo, valor por defecto y descripción.✓ Copiado

→ Tarjeta completa de opciones
Obtén un ejemplo

Dame un fragmento minimal de configuration.nix que habilite zswap con z3fold y 20% de memoria.✓ Copiado

→ Fragmento Nix para copiar y pegar

Resultado: Un uso correcto de opción listo para pegar.

Fija nixpkgs a una versión antigua de un paquete

👤 Usuarios necesitando una versión anterior específica ⏱ ~10 min intermediate

Cuándo usarlo: Una versión más nueva rompió algo y quieres el último commit funcional conocido.

Flujo

Busca versiones históricas

Muestra versiones pasadas de nodejs_20 en nixpkgs con hashes de commit.✓ Copiado

→ Tabla versión→commit
Genera un input de flake

Genera el input de flake fijando nodejs_20 20.15.0 desde ese commit.✓ Copiado

→ Fragmento de flake.nix listo para pegar

Resultado: Un input fijado reproduciblemente para reversión.

Combinar con: filesystem

Descubre opciones de Home Manager para un programa

👤 Cualquiera usando Home Manager ⏱ ~10 min beginner

Cuándo usarlo: Quieres gestionar un programa de forma declarativa pero no estás seguro de qué opciones existen.

Flujo

Lista opciones del programa

Lista cada opción de Home Manager bajo programs.neovim.✓ Copiado

→ Lista de opciones categorizada
Construye un bloque minimal

Dame un bloque minimal de programs.neovim que habilite Telescope y LSP para TS/Python.✓ Copiado

→ Fragmento de HM funcional

Resultado: Una configuración de Home Manager funcional sin leer el manual completo.

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

nixos + filesystem

Busca la opción y escríbela en tu archivo de configuración

Busca la opción de NixOS para habilitar flatpak, luego añádela a ~/nixos/configuration.nix con un comentario.✓ Copiado

nixos + github

Abre un problema cuando falta un paquete

¿Está el paquete foo-cli en nixpkgs? Si no, abre un problema en github en nuestro fork solicitándolo.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar	Coste
nix	action: search\|info\|stats\|options\|channels\|flake-inputs\|cache, args: ...	Cualquier consulta sobre paquetes, opciones, canales	1 consulta a servidor remoto
nix_versions	package: str	Necesitas una versión anterior / fijación de nixpkgs	1 consulta remota

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: APIs públicas; límites generosos pero no infinitos — no hagas muchas solicitudes
Tokens por llamada: Opciones con descripciones: 500-2000 tokens. Las listas pueden ser más grandes.
Monetario: Gratuito
Consejo: Prefiere info en un paquete sobre search retornando 50.

Seguridad

Permisos, secretos, alcance

Almacenamiento de credenciales: Ninguno

Salida de datos: Llamadas a search.nixos.org y APIs públicas relacionadas

Los resultados reflejan lo que retorna la búsqueda ascendente de NixOS — verifica de nuevo contra tu canal.
mcp-nixos no ejecuta Nix; no ejecuta ninguna derivación.

Resolución de problemas

Errores comunes y soluciones

uvx no encontrado

Instala uv: curl -LsSf https://astral.sh/uv/install.sh | sh, luego vuelve a agregar el MCP.

Verificar: uvx --version

Sin resultados para un paquete que sé que existe

La ortografía varía en nombres de atributos — intenta una consulta más flexible o busca por descripción.

Verificar: Reintentar con palabra clave parcial

Información de versión obsoleta

El MCP almacena en caché brevemente; consulta de nuevo en 5 minutos o pasa action=cache para actualizar.

Alternativas

mcp-nixos vs otros

Alternativa	Cuándo usarla	Contrapartida
search.nixos.org directamente	Te está bien tener una pestaña del navegador	Sin IA en el proceso
nix-search CLI	Quieres búsqueda rápida local y tienes Nix instalado	Necesita Nix local + un canal actualizado

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills