mcp-nixos

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

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

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

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

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

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

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

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

Вот и все. Теперь ваш помощник на основе искусственного интеллекта имеет доступ к реальным данным 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)

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

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

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

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

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

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

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

Значительно меньше кода — удалены тысячи строк сложности
100% функциональность - Все по-прежнему работает
0% повреждений кэша — поскольку мы полностью удалили кэш
Операция без сохранения состояния — нет файлов для очистки
Прямой доступ к API — никаких бессмысленных абстракций

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

Данные в реальном времени — всегда актуальные, никогда не устаревающие
Вывод обычного текста — понятен человеку и искусственному интеллекту
Умные подсказки — помогают, когда вы опечатываете названия опций
Кроссплатформенность — работает на Linux, macOS и даже Windows.
Никаких настроек — просто работает™

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

Динамическое разрешение каналов — stable всегда указывает на текущий стабильный канал
Расширенные сообщения об ошибках — действительно полезны, когда что-то идет не так
Дедупликация нестабильных результатов — больше никакого дублирующего спама
Поиск с учетом версии — найдите нужную вам старую версию Ruby
Просмотр категорий — систематическое изучение вариантов

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

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

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

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

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

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

367 тестов , которые действительно проверяют вещи
Настоящие вызовы API, потому что фиктивные вызовы — для трусов
Проверка простого текста, гарантирующая отсутствие утечек XML
Кроссплатформенные тесты , потому что пользователи Windows тоже заслуживают боли

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

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

Переменная	Описание	По умолчанию
`ELASTICSEARCH_URL`	Конечная точка API NixOS	https://search.nixos.org/backend

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

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

NixHub.io — предоставляет историю версий пакетов и отслеживание изменений
search.nixos.org — официальный поиск пакетов и опций NixOS
Jetify — создатели Devbox и NixHub

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

Лицензия

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

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

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

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 — это сервер Model Context Protocol, который предоставляет в режиме реального времени точную информацию о пакетах NixOS, параметрах, Home Manager и конфигурациях nix-darwin, не давая помощникам на базе искусственного интеллекта фантазировать о ресурсах NixOS и позволяя им предоставлять фактические рекомендации по настройке системы.

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