Back to Home
utensils icon

mcp-nixos

by utensils

Overview

Provides accurate, real-time information about NixOS packages, configuration options, Home Manager settings, nix-darwin configurations, and package version history to AI assistants, preventing hallucinations.

Installation

Run Command
docker run --rm -i ghcr.io/utensils/mcp-nixos

Environment Variables

  • ELASTICSEARCH_URL

Security Notes

CRITICAL: The `NIXOS_AUTH` tuple containing username and password (`"aWVSALXpZv", "X8gPHnzL52wFEekuxsfQ9cSh"`) is hardcoded directly in `mcp_nixos/server.py`. While these credentials appear to be for a public Elasticsearch backend (`search.nixos.org`) and are likely read-only, hardcoding any credentials is a severe security vulnerability as it exposes them to anyone with access to the source code, preventing secure rotation and management. The server makes HTTP requests to various external services, including `search.nixos.org`, `nix-community.github.io`, `nix-darwin.github.io`, and `nixhub.io`. Relying on external, potentially untrusted HTML content for parsing (using BeautifulSoup) can introduce risks if the parsing logic is not robust against malformed or malicious data, though BeautifulSoup is generally resilient. User inputs are embedded in Elasticsearch queries (e.g., `wildcard` queries) which, while generally safer when built via dictionaries, could theoretically be resource-intensive or expose edge cases if not rigorously validated. No `eval` or similar dangerous execution patterns were found.

Similar Servers

Stats

Interest Score81
Security Score3
Cost ClassMedium
Avg Tokens1000
Stars355
Forks20
Last Update2025-12-03

Tags

NixOSMCPAI AssistantPackage ManagementConfigurationHome Managernix-darwinFlakesNixHub