VOOZH about

URL: https://glama.ai/mcp/servers/utensils/mcp-nixos?locale=ru-RU

⇱ mcp-nixos by utensils | Glama

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

👁 CI
👁 codecov
👁 PyPI
👁 FlakeHub
👁 Python 3.11+
👁 CodeRabbit Pull Request Reviews
👁 Built with Claude

Быстрый старт

🚨 Nix/NixOS не требуется! Работает на любой системе — Windows, macOS, Linux. Вы просто делаете запросы к API.

Вариант 1: uvx (рекомендуется)

👁 Install MCP Server

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

Вариант 2: Nix

👁 Install MCP Server

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

Вариант 3: Docker

👁 Install MCP Server

{
 "mcpServers": {
 "nixos": {
 "command": "docker",
 "args": ["run", "--rm", "-i", "ghcr.io/utensils/mcp-nixos"]
 }
 }
}

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

Вариант 4: HTTP (удаленный MCP)

FastMCP поддерживает запуск этого сервера через HTTP по URL (эндпоинт MCP по умолчанию — /mcp).

# Run an HTTP MCP server at http://127.0.0.1:8000/mcp
MCP_NIXOS_TRANSPORT=http MCP_NIXOS_HOST=127.0.0.1 MCP_NIXOS_PORT=8000 mcp-nixos

STDIO (по умолчанию):

MCP_NIXOS_TRANSPORT=stdio mcp-nixos

Пользовательский путь:

MCP_NIXOS_TRANSPORT=http MCP_NIXOS_PATH=/api/mcp mcp-nixos

Stateless HTTP (отключает состояние сессии для каждого клиента):

MCP_NIXOS_TRANSPORT=http MCP_NIXOS_STATELESS_HTTP=1 mcp-nixos

Вариант 5: Pi Coding Agent

Pi не поддерживает MCP «из коробки». Есть два поддерживаемых пути:

A. pi-mcp-adapter (рекомендуется — поддерживает MCP, единый источник истины):

pi install npm:pi-mcp-adapter

Затем добавьте в ~/.pi/agent/mcp.json:

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

B. Локальное расширение проекта (клонировать + запустить): этот репозиторий содержит .pi/extensions/mcp-nixos.ts, который автоматически загружается при запуске pi в клонированном репозитории. Опционально: cd .pi && npm install для разрешения типов редактора. Pi запускает его в любом случае.

Related MCP server: MCP-Context-Provider

Что это такое?

MCP-сервер, предоставляющий точную информацию в реальном времени о:

  • Пакетах NixOS — более 130 тысяч реально существующих пакетов

  • Опциях NixOS — более 23 тысяч способов настройки вашей системы

  • Home Manager — более 5 тысяч опций для любителей dotfiles

  • nix-darwin — более 1 тысячи настроек macOS, которые не документирует Apple

  • Nixvim — более 5 тысяч опций для конфигурации Neovim через поиск NuschtOS

  • FlakeHub — более 600 флейков из реестра FlakeHub.com

  • Noogle — более 2 тысяч функций Nix с сигнатурами типов через noogle.dev

  • NixOS Wiki — документация сообщества и руководства с wiki.nixos.org

  • nix.dev — официальные руководства и туториалы по Nix с nix.dev

  • Версиях пакетов — исторические версии с хешами коммитов через NixHub.io

  • Статусе бинарного кеша — проверка наличия пакетов в кеше cache.nixos.org с размерами загрузки

  • Локальных входных данных флейков — изучение ваших закрепленных зависимостей флейков прямо из хранилища Nix (требуется Nix)

Инструменты

Всего два. Мы объединили 17 инструментов в 2, потому что контекстное окно вашего ИИ не бесконечно.

Всего ~1030 токенов. Вот и всё. Пока другие MCP-серверы поглощают ваш контекст, как будто это «Черная пятница», мы попиваем минималистичный чай в сторонке. Ваш ИИ получает суперсилы NixOS без лишнего «мусора».

nix — Универсальный инструмент запросов

Один инструмент, чтобы править всеми:

nix(action, query, source, type, channel, limit)

Действие

Что делает

search

Поиск пакетов, опций, программ или флейков

info

Получение подробной информации о пакете или опции

stats

Получение количества и категорий

options

Просмотр опций Home Manager/Darwin по префиксу

channels

Список доступных каналов NixOS

flake-inputs

Изучение локальных входных данных флейков из хранилища Nix

cache

Проверка статуса бинарного кеша для пакетов

Источник

Что запрашивает

nixos

Пакеты, опции, программы

home-manager

Опции Home Manager

darwin

Опции nix-darwin

flakes

Флейки сообщества (search.nixos.org)

flakehub

Реестр FlakeHub (flakehub.com)

nixvim

Опции конфигурации Nixvim Neovim

noogle

Сигнатуры функций Nix и документация (noogle.dev)

wiki

Статьи NixOS Wiki (wiki.nixos.org)

nix-dev

Официальная документация Nix (nix.dev)

nixhub

Метаданные пакетов и пути в хранилище (nixhub.io)

Примеры:

# Search NixOS packages
nix(action="search", query="firefox", source="nixos", type="packages")

# Get package info
nix(action="info", query="firefox", source="nixos", type="package")

# Search Home Manager options
nix(action="search", query="git", source="home-manager")

# Browse darwin options
nix(action="options", source="darwin", query="system.defaults")

# Search Nixvim options
nix(action="search", query="telescope", source="nixvim")

# Get Nixvim option info
nix(action="info", query="plugins.telescope.enable", source="nixvim")

# Search FlakeHub
nix(action="search", query="nixpkgs", source="flakehub")

# Get FlakeHub flake info
nix(action="info", query="NixOS/nixpkgs", source="flakehub")

# Search Noogle for Nix functions
nix(action="search", query="mapAttrs", source="noogle")

# Get Noogle function info
nix(action="info", query="lib.attrsets.mapAttrs", source="noogle")

# Browse Noogle function categories
nix(action="options", source="noogle", query="lib.strings")

# Search NixOS Wiki
nix(action="search", query="nvidia", source="wiki")

# Get Wiki page info
nix(action="info", query="Flakes", source="wiki")

# Search nix.dev documentation
nix(action="search", query="packaging tutorial", source="nix-dev")

# Search NixHub for package metadata
nix(action="search", query="nodejs", source="nixhub")

# Get detailed package info from NixHub (license, homepage, store paths)
nix(action="info", query="python", source="nixhub")

# Check binary cache status
nix(action="cache", query="hello")

# Check cache for specific version
nix(action="cache", query="python", version="3.12.0")

# Check cache for specific system
nix(action="cache", query="firefox", system="x86_64-linux")

# Get stats
nix(action="stats", source="nixos", channel="stable")

# List local flake inputs (requires Nix)
nix(action="flake-inputs", type="list")

# Browse files in a flake input
nix(action="flake-inputs", type="ls", query="nixpkgs:pkgs/by-name")

# Read a file from a flake input
nix(action="flake-inputs", type="read", query="nixpkgs:flake.nix")

nix_versions — История версий пакетов

Поиск исторических версий с хешами коммитов nixpkgs. Вывод включает:

  • Метаданные пакета (лицензия, домашняя страница, программы), если доступны

  • Доступность платформы для каждой версии (Linux/macOS)

  • Хеш коммита Nixpkgs для воспроизводимых сборок

  • Путь атрибута для выражений Nix

nix_versions(package, version, limit)

Примеры:

# List recent versions with metadata
nix_versions(package="python", limit=5)

# Find specific version
nix_versions(package="nodejs", version="20.0.0")

Установка

Вам НЕ нужно устанавливать Nix. Это работает везде, где работает Python.

# Run directly (no install)
uvx mcp-nixos

# Or install
pip install mcp-nixos

Для пользователей Nix:

nix run github:utensils/mcp-nixos
nix profile install github:utensils/mcp-nixos

Декларативная установка (NixOS / Home Manager / nix-darwin)

mcp-nixos доступен в nixpkgs:

# NixOS (configuration.nix)
environment.systemPackages = [ pkgs.mcp-nixos ];

# Home Manager (home.nix)
home.packages = [ pkgs.mcp-nixos ];

# nix-darwin (darwin-configuration.nix)
environment.systemPackages = [ pkgs.mcp-nixos ];

Или используйте флейк напрямую с предоставленным оверлеем:

# flake.nix
{
 inputs = {
 nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
 mcp-nixos.url = "github:utensils/mcp-nixos";
 };

 outputs = { self, nixpkgs, mcp-nixos, ... }: {
 # Example: NixOS configuration
 nixosConfigurations.myhost = nixpkgs.lib.nixosSystem {
 system = "x86_64-linux";
 modules = [{
 nixpkgs.overlays = [ mcp-nixos.overlays.default ];
 environment.systemPackages = [ pkgs.mcp-nixos ];
 }];
 };

 # Example: Home Manager standalone
 homeConfigurations.myuser = home-manager.lib.homeManagerConfiguration {
 pkgs = import nixpkgs {
 system = "x86_64-linux";
 overlays = [ mcp-nixos.overlays.default ];
 };
 modules = [{
 home.packages = [ pkgs.mcp-nixos ];
 }];
 };
 };
}

Разработка

nix develop # Enter dev shell
nix build # Build package
pytest tests/ # Run tests
ruff check . # Lint
ruff format . # Format
mypy mcp_nixos/ # Type check

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

  • NixHub.io — история версий пакетов

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

  • FlakeHub — реестр флейков от Determinate Systems

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

  • Noogle — поисковая система функций Nix

  • NuschtOS — инфраструктура статического поиска опций, обеспечивающая поддержку Nixvim

  • Nixvim — фреймворк конфигурации Neovim для Nix

Лицензия

MIT — потому что делиться — значит заботиться.

Создано Джеймсом Бринком. Поддерживается мазохистами-энтузиастами, которые любят Nix.

A
license - permissive license
A
quality
B
maintenance

Maintenance

–Maintainers
21hResponse time
3wRelease cycle
15Releases (12mo)
Commit activity
Issues opened vs closed

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/utensils/mcp-nixos'

If you have feedback or need assistance with the MCP directory API, please join our Discord server