mcp-nixos

MCP-NixOS: Porque tu asistente de IA no debería alucinar con los paquetes

🎉 REFACTORADO : La versión 1.0.0 representa una reescritura completa que simplificó todo drásticamente. Eliminamos el almacenamiento en caché complejo, las abstracciones y los patrones empresariales. Porque a veces menos es más, y más es solo presumir.

Inicio rápido (porque quieres usarlo AHORA)

¡No necesitas Nix/NixOS! Esta herramienta funciona en cualquier sistema: Windows, macOS, Linux. Solo necesitas consultar las API web.

Opción 1: Usar uvx (recomendado para la mayoría de los usuarios)

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

Opción 2: Usar Nix (para usuarios de Nix)

{
  "mcpServers": {
    "nixos": {
      "command": "nix",
      "args": ["run", "github:utensils/mcp-nixos", "--"]
    }
  }
}

Listo. Tu asistente de IA ahora tiene acceso a datos reales de NixOS en lugar de inventarlos. De nada.

¿Qué es esta cosa?

MCP-NixOS es un servidor de protocolo de contexto de modelo que le brinda a su asistente de IA información precisa y en tiempo real sobre:

Paquetes de NixOS (más de 130 000 paquetes que realmente existen)
Opciones de configuración (más de 22.000 formas de dañar tu sistema)
Configuración de Home Manager (opciones 4K+ para usuarios avanzados)
Configuraciones de nix-darwin (más de 1000 configuraciones de macOS que Apple no quiere que toques)
Historial de versiones del paquete a través de NixHub.io (Encuentre ese antiguo Ruby 2.6 con hashes de confirmación)

Las herramientas que realmente te importan

Herramientas de NixOS

nixos_search(query, type, channel) - Busca paquetes, opciones o programas
nixos_info(name, type, channel) : obtiene información detallada sobre paquetes/opciones
nixos_stats(channel) - Recuento de paquetes y opciones
nixos_channels() - Lista todos los canales disponibles
nixos_flakes_search(query) - Buscar flakes de la comunidad
nixos_flakes_stats() - Estadísticas del ecosistema Flake

📦 Herramientas de historial de versiones (¡NUEVO!)

nixhub_package_versions(package, limit) : obtiene el historial de versiones con hashes de confirmación
nixhub_find_version(package, version) : búsqueda inteligente de versiones específicas

Herramientas del administrador del hogar

home_manager_search(query) - Buscar opciones de configuración del usuario
home_manager_info(name) - Obtener detalles de la opción (¡con sugerencias!)
home_manager_stats() - Ver lo que está disponible
home_manager_list_options() - Explorar las 131 categorías
home_manager_options_by_prefix(prefix) - Explorar opciones por prefijo

Herramientas de Darwin

darwin_search(query) - Opciones de búsqueda en macOS
darwin_info(name) - Obtener detalles de la opción
darwin_stats() - Estadísticas de configuración de macOS
darwin_list_options() - Explorar las 21 categorías
darwin_options_by_prefix(prefix) : Explora las opciones de macOS

Opciones de instalación

Recuerda: ¡NO necesitas tener instalado Nix/NixOS! Esta herramienta funciona en cualquier plataforma donde se ejecute Python.

Para personas comunes (Windows/Mac/Linux)

# Run directly with uvx (no installation needed)
uvx mcp-nixos

# Or install globally
pip install mcp-nixos
uv pip install mcp-nixos

Para usuarios de Nix (ustedes saben quiénes son)

# Run without installing
nix run github:utensils/mcp-nixos

# Install to profile
nix profile install github:utensils/mcp-nixos

Características que vale la pena mencionar

🚀 Versión 1.0.0: La Gran Simplificación

Drásticamente menos código : se eliminaron miles de líneas de complejidad
100% de funcionalidad - Todo sigue funcionando
0% de corrupción de caché : porque eliminamos la caché por completo
Operación sin estado : no hay archivos que limpiar
Acceso directo a la API : sin abstracciones innecesarias

📊 Lo que obtienes

Datos en tiempo real : siempre actualizados, nunca obsoletos
Salida de texto simple : legible para humanos e IA
Sugerencias inteligentes : ayuda cuando escribes mal los nombres de las opciones
Multiplataforma : funciona en Linux, macOS y sí, incluso en Windows.
Sin configuración , simplemente funciona™

🎯 Mejoras clave

Resolución de canal dinámico : stable siempre apunta a estable actual
Mensajes de error mejorados : realmente útiles cuando las cosas salen mal
Resultados de flake deduplicados : no más spam duplicado
Búsquedas basadas en versiones : encuentre la versión antigua de Ruby que necesita
Exploración por categorías : explore las opciones sistemáticamente

Para desarrolladores (los valientes)

Con Nix (El Camino Bendito)

nix develop
menu  # Shows all available commands

# Common tasks
run        # Start the server
run-tests  # Run all tests
lint       # Format and check code
typecheck  # Check types

Sin Nix (El camino del dolor)

pip install -e ".[dev]"
pytest tests/
black mcp_nixos/
flake8 mcp_nixos/

Filosofía de prueba

367 pruebas que realmente prueban cosas
Llamadas API reales porque las simulaciones son para cobardes
Validación de texto simple que garantiza que no haya fugas de XML
Pruebas multiplataforma porque los usuarios de Windows también merecen el dolor

Variables de entorno

Solo uno. Ahora somos minimalistas:

Variable	Descripción	Por defecto
`ELASTICSEARCH_URL`	Punto final de la API de NixOS	https://search.nixos.org/backend

Expresiones de gratitud

Este proyecto consulta datos de varios servicios sorprendentes:

NixHub.io : proporciona historial de versiones de paquetes y seguimiento de confirmaciones
search.nixos.org - Búsqueda oficial de paquetes y opciones de NixOS
Jetify - Creadores de Devbox y NixHub

Nota: Estos servicios no han respaldado esta herramienta. Solo agradecemos a los usuarios de la API.

Licencia

MIT - Porque compartir es cuidar, incluso si el código duele.

Creado por James Brink y mantenido por masoquistas que disfrutan de Nix.

Un agradecimiento especial al proyecto NixOS por crear un sistema operativo que es al mismo tiempo lo mejor y lo peor que ha existido jamás.

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

View all tools

MCP-NixOS es un servidor de protocolo de contexto de modelo que brinda información precisa y en tiempo real sobre los paquetes, las opciones, el Home Manager y las configuraciones de nix-darwin de NixOS, lo que evita que los asistentes de IA alucinen sobre los recursos de NixOS y les permite brindar una guía de configuración del sistema basada en hechos.

Related Resources

Reddit Discussion about this server

Related MCP Servers

MCP-Guide
qpd-v
A
security
A
license
A
quality
A beginner-friendly Model Context Protocol (MCP) server that helps users understand MCP concepts, provides interactive examples, and lists available MCP servers. This server is designed to be a helpful companion for developers working with MCP. Also comes with a huge list of servers you can install.
Last updated -
3
9
36
JavaScript
Apache 2.0
Sleep MCP Server
Garoth
A
security
F
license
A
quality
A Model Context Protocol (MCP) server that provides a simple sleep/wait tool, useful for adding delays between operations such as waiting between API calls or testing eventually consistent systems.
Last updated -
1
6
7
JavaScript
MCP Maker
CaptainCrouton89
-
security
-
license
-
quality
A specialized server that helps users create new Model Context Protocol (MCP) servers by providing tools and templates for scaffolding projects with various capabilities.
Last updated -
1
TypeScript
MCP API Service
nstanw
-
security
-
license
-
quality
A Model Context Protocol (MCP) server that interacts with system APIs, allowing users to check connections, search employees, register breakfast, and update chemical information by shifts.
Last updated -
2

View all related MCP servers