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

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

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

Вариант 2: Никс

Вариант 3: Docker

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

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

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

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

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

Бессостоятельный HTTP (отключает состояние сессии для каждого клиента):

Вариант 5: Агент кодирования Pi

Пи не говорит на MCP на родном языке. Два поддерживаемых пути:

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

Затем добавьте к [[T1]:

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

Что это?

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

• NixOS-пакеты - 130K+ пакеты, которые действительно существуют
• Опции NixOS - 23K+ способов настройки вашей системы
• Home Manager - 5K+ опций для энтузиастов dotfile

MCP-NixOS - Because Your AI Shouldn’t Hallucinate Package Names

Quick Start

🚨 No Nix/NixOS Required! Works on any system - Windows, macOS, Linux. You’re just querying APIs.

Option 1: uvx (Recommended)

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

Option 2: Nix

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

Option 3: Docker

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

Your AI now has access to real NixOS data instead of making things up. You’re welcome.

Option 4: HTTP (Remote MCP)

FastMCP supports running this server over HTTP at a URL (the MCP endpoint defaults to /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 (default):

MCP_NIXOS_TRANSPORT=stdio mcp-nixos

Custom path:

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

Stateless HTTP (disables per-client session state):