MCP-NixOS — потому что ваш помощник на основе искусственного интеллекта не должен галлюцинировать о пакетах

🎉 РЕФАКТОРИЗОВАННЫЙ : Версия 1.0.0 представляет собой полную переработку, которая радикально упростила все. Мы удалили все сложное кэширование, абстракции и шаблоны «корпоративности». Потому что иногда меньше значит больше, а больше — это просто понты.

Быстрый старт (потому что вы хотите использовать его СЕЙЧАС)

🚨 Nix/NixOS не требуется! Этот инструмент работает на любой системе - Windows, macOS, Linux. Вы просто запрашиваете веб-API.

Вариант 1: Использование uvx (рекомендуется для большинства пользователей)

Вариант 2: Использование Nix (для пользователей Nix)

Вот и все. Теперь ваш помощник на основе искусственного интеллекта имеет доступ к реальным данным NixOS, а не к выдумкам. Пожалуйста.

Что это за штука?

MCP-NixOS — это сервер Model Context Protocol, который предоставляет вашему помощнику на базе искусственного интеллекта точную информацию в режиме реального времени о:

• Пакеты NixOS (более 130 тыс. пакетов, которые действительно существуют)

• Параметры конфигурации (более 22 тыс. способов взломать вашу систему)

• Настройки Home Manager (опции 4K+ для опытных пользователей)

• Конфигурации nix-darwin (более 1 тыс. настроек macOS, которые Apple не хочет, чтобы вы трогали)

• История версий пакетов через NixHub.io (Найдите древний Ruby 2.6 с хэшами коммитов)

Инструменты, которые вам действительно нужны

🔍 Инструменты NixOS

• nixos_search(query, type, channel) — Поиск пакетов, опций или программ

• nixos_info(name, type, channel) - Получить подробную информацию о пакетах/опциях

• nixos_stats(channel) — Количество пакетов и опций

• nixos_channels() — список всех доступных каналов

• nixos_flakes_search(query) - Поиск сообщества flakes

• nixos_flakes_stats() - Статистика экосистемы Flake

📦 Инструменты истории версий (НОВИНКА!)

• nixhub_package_versions(package, limit) — Получить историю версий с хэшами коммитов

• nixhub_find_version(package, version) — Умный поиск определенных версий

🏠 Инструменты домашнего менеджера

• home_manager_search(query) — Поиск параметров конфигурации пользователя

• home_manager_info(name) - Получить подробную информацию о параметрах (с предложениями!)

• home_manager_stats() - Посмотреть, что доступно

• home_manager_list_options() - Просмотреть все 131 категории

• home_manager_options_by_prefix(prefix) — изучить параметры по префиксу

🍎 Дарвиновские инструменты

• darwin_search(query) — Поиск параметров macOS

• darwin_info(name) — Получить сведения об опции

• darwin_stats() - статистика конфигурации macOS

• darwin_list_options() - Просмотреть все 21 категории

• darwin_options_by_prefix(prefix) — изучение параметров macOS

Варианты установки

Помните: Вам НЕ НУЖНО устанавливать Nix/NixOS! Этот инструмент работает везде, где работает Python.

Для обычных людей (Windows/Mac/Linux)

Для пользователей Nix (Вы знаете, кто вы)

Особенности, которые стоит упомянуть

🚀 Версия 1.0.0: Великое упрощение

• Значительно меньше кода — удалены тысячи строк сложности

• 100% функциональность - Все по-прежнему работает

• 0% повреждений кэша — поскольку мы полностью удалили кэш

• Операция без сохранения состояния — нет файлов для очистки

• Прямой доступ к API — никаких бессмысленных абстракций

📊 Что вы получаете

• Данные в реальном времени — всегда актуальные, никогда не устаревающие

• Вывод обычного текста — понятен человеку и искусственному интеллекту

• Умные подсказки — помогают, когда вы опечатываете названия опций

• Кроссплатформенность — работает на Linux, macOS и даже Windows.

• Никаких настроек — просто работает™

🎯 Ключевые улучшения

• Динамическое разрешение каналов — stable всегда указывает на текущий стабильный канал

• Расширенные сообщения об ошибках — действительно полезны, когда что-то идет не так

• Дедупликация нестабильных результатов — больше никакого дублирующего спама

• Поиск с учетом версии — найдите нужную вам старую версию Ruby

• Просмотр категорий — систематическое изучение вариантов

Для разработчиков (смелых)

С Никсом (Благословенный Путь)

Без Никса (Путь Боли)

Философия тестирования

• 367 тестов , которые действительно проверяют вещи

• Настоящие вызовы API, потому что фиктивные вызовы — для трусов

• Проверка простого текста, гарантирующая отсутствие утечек XML

• Кроссплатформенные тесты , потому что пользователи Windows тоже заслуживают боли

Переменные среды

Только один. Мы теперь минималисты:

Благодарности

Этот проект запрашивает данные из нескольких замечательных сервисов:

• NixHub.io — предоставляет историю версий пакетов и отслеживание изменений

• search.nixos.org — официальный поиск пакетов и опций NixOS

• Jetify — создатели Devbox и NixHub

Примечание: Эти сервисы не одобрили этот инструмент. Мы просто благодарные потребители API.

Лицензия

MIT - Потому что делиться - значит заботиться, даже если код вредит.

Создано Джеймсом Бринком и поддерживается мазохистами, которым нравится Nix.

Особая благодарность проекту NixOS за создание ОС, которая одновременно является и лучшим, и худшим из всего, что было.