MCP-NixOS

MCP-NixOS

MCP-NixOS server providing accurate real-time NixOS data to AI assistants.

343
Stars
18
Forks
4
Releases

Overview

MCP-NixOS is a Model Context Protocol server that gives AI assistants access to accurate, real-time information about NixOS packages, configuration options, Home Manager settings, and nix-darwin macOS configurations. It also surfaces package version history via NixHub. The server exposes a comprehensive set of MCP endpoints for discovering and querying data, including NixOS search and info, channel and flake statistics, and dedicated Home Manager and Darwin tooling. Version history is supported through nixhub_package_versions and nixhub_find_version. The project emphasizes real-time data, plain text output, cross-platform compatibility, and stateless operation. It runs on any system (Windows, macOS, Linux) without requiring a full Nix/NixOS installation, and multiple deployment options are provided (uvx, nix run, or Docker). An asynchronous FastMCP 2.x implementation ensures modern, non-blocking I/O. The design prioritizes minimal configuration, dynamic channel resolution, helpful error messages, and deduplicated results to keep AI assistants informed with current, actionable data.

Details

Owner
utensils
Language
HTML
License
MIT License
Updated
2025-12-07

Features

NixOS Tools

A suite of NixOS-specific commands (nixos_search, nixos_info, nixos_stats, nixos_channels, nixos_flakes_search, nixos_flakes_stats) for discovering packages, options, channels, and flakes.

NixHub Version History

Access to package version histories and commit data via nixhub_package_versions and nixhub_find_version for historical context.

Home Manager Tools

Tools to search and inspect Home Manager options, plus statistics and curated browsing (home_manager_search, home_manager_info, home_manager_stats, home_manager_list_options, home_manager_options_by_prefix).

Darwin Tools

macOS configuration tooling for nix-darwin options (darwin_search, darwin_info, darwin_stats, darwin_list_options, darwin_options_by_prefix).

Real-time, Plain Text Output

Real-time data feeds with human- and AI-friendly plain text output, designed for fast, readable responses.

Async & Stateless MCP

Modern asynchronous FastMCP 2.x implementation with stateless operation and minimal caching for reliable, scalable queries.

Cross-Platform & No Local Nix Required

Runs anywhere Python runs; no Nix/NixOS installation required, with deployment options via uvx, nix, or Docker.

Audience

AI developersIntegrate real-time NixOS data into AI assistants and chat agents via MCP endpoints.
MCP client developersTest, develop, and deploy MCP clients against a real NixOS data backend in local or CI environments.
NixOS power usersQuery up-to-date NixOS packages, options, and Home Manager settings to inform decisions and configurations.

Tags

NixOSNixNixOS packagesHome Managernix-darwinNixHubMCPModel Context Protocolreal-timeAI assistantsasync