Overview: MCP-NixOS - Because Your AI Assistant Shouldn't Hallucinate About Packages

Title

MCP-NixOS – A Model Context Protocol server that ensures your AI assistant provides accurate information about NixOS packages, system options, and configurations.

How to Use

1. Quick Setup: Configure your AI assistant to use MCP-NixOS by adding the following to your settings:

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

2. Environment Variables: Customize behavior using variables like MCP_NIXOS_LOG_LEVEL, MCP_NIXOS_CACHE_DIR, and ELASTICSEARCH_URL.
3. Search & Query: Use built-in tools like nixos_search(), home_manager_info(), and darwin_options_by_prefix() to retrieve accurate NixOS-related data.

Key Features

• Real-Time NixOS Data: Access up-to-date packages, system options, and configurations.
• Multi-Channel Support: Query unstable, stable, or specific NixOS versions.
• Home Manager & nix-darwin: Get detailed user and macOS configuration options.
• Smart Caching: Reduces network requests and enables offline functionality.
• Rich Search Capabilities: Fast in-memory search with related-option suggestions.

Use Cases

• AI Assistants: Prevent hallucinations by providing verified NixOS package and option details.
• Developers: Quickly search for NixOS configurations without manual documentation checks.
• Home Manager Users: Retrieve precise user-level settings for programs and services.
• macOS Nix Enthusiasts: Configure nix-darwin options with accurate, structured data.
• Offline Workflows: Cache NixOS data for use in environments with limited connectivity.

MCP-NixOS ensures reliability and correctness, making NixOS configuration less frustrating and more efficient. 🚀