MCP.so
Sign In

MCP-NixOS - Because Your AI Assistant Shouldn't Hallucinate About Packages

@utensils

About MCP-NixOS - Because Your AI Assistant Shouldn't Hallucinate About Packages

MCP-NixOS - Model Context Protocol Server for NixOS resources

Basic information

Category

AI & Agents

License

MIT

Runtime

python

Transports

stdio

Publisher

utensils

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is MCP-NixOS?

MCP-NixOS is an MCP server that provides accurate, real-time information about NixOS packages, options, Home Manager, nix-darwin, Nixvim, FlakeHub, Noogle, NixOS Wiki, nix.dev, package versions (via NixHub), binary cache status, and local flake inputs. It integrates with multiple APIs and is designed for AI assistants that need reliable NixOS data without hallucinations. It works on any system (Windows, macOS, Linux) and does not require Nix installed.

How to use MCP-NixOS?

Install and run via uvx mcp-nixos (recommended), pip install mcp-nixos, nix run github:utensils/mcp-nixos, or Docker (ghcr.io/utensils/mcp-nixos). Configure as an MCP server in your client (e.g., Cursor, Claude, Pi) using the nixos server name. Two tools are provided: nix (unified query with actions like search, info, stats, cache, flake-inputs) and nix_versions (package version history). Transport defaults to STDIO; set environment variables MCP_NIXOS_TRANSPORT=http and optionally MCP_NIXOS_HOST, MCP_NIXOS_PORT, MCP_NIXOS_PATH, MCP_NIXOS_STATELESS_HTTP for HTTP mode.

Key features of MCP-NixOS

  • Two consolidated tools (~1030 tokens total).
  • No Nix installation required (runs anywhere Python runs).
  • Queries 130K+ packages and 23K+ NixOS options.
  • Supports STDIO and HTTP transports.
  • Includes binary cache status checking.
  • Accesses FlakeHub, Noogle, NixOS Wiki, nix.dev, and NixHub.

Use cases of MCP-NixOS

  • Search for NixOS packages or options and get real-time, accurate results.
  • Check binary cache

Comments

More AI & Agents MCP servers