mcp-nixos

MCP-NixOS – Weil Ihr KI-Assistent nicht über Pakete halluzinieren sollte

🎉 REFACTORED : Version 1.0.0 stellt eine komplette Neufassung dar, die alles drastisch vereinfacht hat. Wir haben alle komplexen Caching-, Abstraktions- und „Enterprise“-Muster entfernt. Denn manchmal ist weniger mehr, und mehr ist nur Angeberei.

Schnellstart (weil Sie es JETZT verwenden möchten)

🚨 Kein Nix/NixOS erforderlich! Dieses Tool funktioniert auf jedem System – Windows, macOS, Linux. Sie fragen lediglich Web-APIs ab.

Option 1: Verwenden von uvx (für die meisten Benutzer empfohlen)

Option 2: Verwenden von Nix (für Nix-Benutzer)

Das war’s. Ihr KI-Assistent hat jetzt Zugriff auf echte NixOS-Daten, anstatt sich Dinge auszudenken. Gern geschehen.

Was ist das?

MCP-NixOS ist ein Model Context Protocol-Server, der Ihrem KI-Assistenten genaue Echtzeitinformationen zu folgenden Punkten liefert:

• NixOS-Pakete (über 130.000 tatsächlich vorhandene Pakete)
• Konfigurationsoptionen (über 22.000 Möglichkeiten, Ihr System zu beschädigen)
• Home Manager-Einstellungen (4K+-Optionen für Power-User)
• Nix-Darwin-Konfigurationen (mehr als 1.000 macOS-Einstellungen, die Apple vor Ihnen schützen möchte)
• Paketversionsverlauf über NixHub.io (Finden Sie das alte Ruby 2.6 mit Commit-Hashes)

Die Tools, die Sie wirklich interessieren

🔍 NixOS-Tools

• nixos_search(query, type, channel) – Pakete, Optionen oder Programme suchen
• nixos_info(name, type, channel) – Erhalten Sie detaillierte Informationen zu Paketen/Optionen
• nixos_stats(channel) – Anzahl der Pakete und Optionen
• nixos_channels() - Listet alle verfügbaren Kanäle auf
• nixos_flakes_search(query) – Community-Flakes suchen
• nixos_flakes_stats() – Statistiken zum Flake-Ökosystem

📦 Versionsverlaufstools (NEU!)

• nixhub_package_versions(package, limit) – Versionsverlauf mit Commit-Hashes abrufen
• nixhub_find_version(package, version) – Intelligente Suche nach bestimmten Versionen

🏠 Home Manager-Tools

• home_manager_search(query) – Benutzerkonfigurationsoptionen durchsuchen
• home_manager_info(name) – Optionsdetails abrufen (mit Vorschlägen!)
• home_manager_stats() - Sehen Sie, was verfügbar ist
• home_manager_list_options() – Alle 131 Kategorien durchsuchen
• home_manager_options_by_prefix(prefix) – Optionen nach Präfix erkunden

🍎 Darwin-Tools

• darwin_search(query) – macOS-Optionen durchsuchen
• darwin_info(name) – Optionsdetails abrufen
• darwin_stats() – macOS-Konfigurationsstatistiken
• darwin_list_options() – Alle 21 Kategorien durchsuchen
• darwin_options_by_prefix(prefix) – macOS-Optionen erkunden

Installationsoptionen

Denken Sie daran: Sie müssen Nix/NixOS NICHT installiert haben! Dieses Tool läuft überall, wo Python läuft.

Für normale Menschen (Windows/Mac/Linux)

Für Nix-Benutzer (Sie wissen, wer Sie sind)

Erwähnenswerte Funktionen

🚀 Version 1.0.0: Die große Vereinfachung

• Deutlich weniger Code – Tausende Zeilen Komplexität wurden entfernt
• 100% Funktionalität - Alles funktioniert noch
• 0 % Cache-Beschädigung – Weil wir den Cache vollständig entfernt haben
• Zustandsloser Betrieb – Keine zu bereinigenden Dateien
• Direkter API-Zugriff – Kein Abstraktions-Unsinn

📊 Was Sie bekommen

• Echtzeitdaten – Immer aktuell, nie veraltet
• Klartextausgabe – für Menschen und KI lesbar
• Intelligente Vorschläge - Hilft, wenn Sie Optionsnamen falsch eingeben
• Plattformübergreifend – Funktioniert unter Linux, macOS und ja, sogar Windows
• Keine Konfiguration – es funktioniert einfach™

🎯 Wichtige Verbesserungen

• Dynamische Kanalauflösung - stable zeigt immer auf den aktuellen stabilen
• Verbesserte Fehlermeldungen – Wirklich hilfreich, wenn etwas schief geht
• Deduplizierte Flake-Ergebnisse – Schluss mit doppeltem Spam
• Versionsabhängige Suche – Finden Sie die alte Ruby-Version, die Sie benötigen
• Kategorien durchsuchen – Optionen systematisch erkunden

Für Entwickler (die Mutigen)

Mit Nix (Der gesegnete Pfad)

Ohne Nix (Der Pfad des Schmerzes)

Testphilosophie

• 367 Tests , die tatsächlich Dinge testen
• Echte API-Aufrufe , denn Mocks sind für Feiglinge
• Klartextvalidierung stellt sicher, dass kein XML durchsickert
• Plattformübergreifende Tests , weil auch Windows-Benutzer Schmerzen verdienen

Umgebungsvariablen

Nur eines. Wir sind jetzt Minimalisten:

Danksagung

Dieses Projekt fragt Daten von mehreren erstaunlichen Diensten ab:

• NixHub.io – Bietet Paketversionsverlauf und Commit-Tracking
• search.nixos.org – Offizielle NixOS-Paket- und Optionssuche
• Jetify – Entwickler von Devbox und NixHub

Hinweis: Diese Dienste haben dieses Tool nicht empfohlen. Wir sind lediglich dankbare API-Nutzer.

Lizenz

MIT – Weil Teilen Fürsorge bedeutet, auch wenn der Code weh tut.

Erstellt von James Brink und gepflegt von Masochisten, die Nix mögen.

Besonderer Dank gilt dem NixOS-Projekt für die Entwicklung eines Betriebssystems, das gleichzeitig das Beste und das Schlimmste aller Zeiten ist.