MCP-NixOS MCP Server

What does “MCP-NixOS” MCP Server do?

MCP-NixOS is a Model Context Protocol (MCP) Server specifically designed to interface with NixOS resources. It acts as a bridge between AI assistants and the NixOS ecosystem, enabling seamless access to NixOS configuration, package management, and system state. By exposing NixOS data and operations through the MCP standard, MCP-NixOS empowers developers and AI systems to query, manage, and interact with NixOS environments programmatically. This facilitates workflows such as automated system configuration, package discovery, and state introspection—making it highly valuable for infrastructure automation, reproducible builds, and AI-powered DevOps tasks.

List of Prompts

No prompt templates were found in the repository or its documentation.

List of Resources

No explicit MCP resources were documented or found in the repository structure or documentation.

List of Tools

No explicit tools were found in the server.py or equivalent implementation files in the repository.

Use Cases of this MCP Server

• NixOS Configuration Exploration
  Developers and AI systems can introspect NixOS configurations, making it easier to understand system setups and automate documentation.
• Automated Package Management
  The server can be used to query and manage NixOS packages, streamlining development and deployment pipelines.
• System State Introspection
  Enables real-time querying of current system state, useful for monitoring, troubleshooting, and self-healing infrastructure.
• Declarative Infrastructure Automation
  Facilitates AI-driven updates or validation of declarative system configurations, ensuring consistency and reproducibility.
• Integration with LLM-based DevOps Agents
  AI agents can leverage MCP-NixOS to perform actions or gather context, enhancing their ability to assist with NixOS-based workflows.

How to set it up

Windsurf

1. Ensure you have Node.js and Windsurf installed.
2. Open your Windsurf configuration file.
3. Add the MCP-NixOS server entry to the mcpServers section.
4. Save the configuration and restart Windsurf.
5. Verify the setup by running a test query via the UI.

{
  "mcpServers": {
    "mcp-nixos": {
      "command": "npx",
      "args": ["@utensils/mcp-nixos@latest"]
    }
  }
}

Claude

1. Install Node.js and Claude if not already present.
2. Locate Claude’s configuration file.
3. Insert the MCP-NixOS server details under the mcpServers key.
4. Save changes and restart Claude.
5. Confirm the server is accessible from Claude’s interface.

{
  "mcpServers": {
    "mcp-nixos": {
      "command": "npx",
      "args": ["@utensils/mcp-nixos@latest"]
    }
  }
}

Cursor

1. Make sure Cursor and Node.js are installed.
2. Edit the Cursor configuration file.
3. Add MCP-NixOS in the mcpServers section.
4. Save the config and restart Cursor.
5. Use Cursor’s interface to test connectivity.

{
  "mcpServers": {
    "mcp-nixos": {
      "command": "npx",
      "args": ["@utensils/mcp-nixos@latest"]
    }
  }
}

Cline

1. Install Node.js and Cline.
2. Open Cline’s main config file.
3. Add MCP-NixOS to the mcpServers array.
4. Save and restart Cline.
5. Run a basic MCP command to verify the integration.

{
  "mcpServers": {
    "mcp-nixos": {
      "command": "npx",
      "args": ["@utensils/mcp-nixos@latest"]
    }
  }
}

Note:
To secure API keys or sensitive environment variables, use the env field in your configuration. Example:

{
  "mcpServers": {
    "mcp-nixos": {
      "command": "npx",
      "args": ["@utensils/mcp-nixos@latest"],
      "env": {
        "API_KEY": "${API_KEY}"
      },
      "inputs": {
        "apiKey": "${API_KEY}"
      }
    }
  }
}

How to use this MCP inside flows

Using MCP in FlowHunt

To integrate MCP servers into your FlowHunt workflow, start by adding the MCP component to your flow and connecting it to your AI agent:

Click on the MCP component to open the configuration panel. In the system MCP configuration section, insert your MCP server details using this JSON format:

{
  "mcp-nixos": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Once configured, the AI agent is now able to use this MCP as a tool with access to all its functions and capabilities. Remember to change “mcp-nixos” to your actual MCP server name and replace the URL with your own MCP server URL.

Overview

I would rate this MCP server as a 5/10: it has strong documentation for setup and use cases, but lacks explicit prompt templates, resources, and tools in the current repository state.

MCP Score