快速启动

** 🚨 不需要 Nix/NixOS ！** 任何系统都能用——Windows、macOS、Linux。你只是查询 API。

选项1：UVX（推荐）

选项2：放弃

选项3：Docker

你的AI现在可以访问真实的NixOS数据，而不是编造信息。不客气。

选项4：HTTP（远程MCP）

FastMCP 支持通过 HTTP 在 URL 上运行该服务器（MCP 端点默认为 /mcp。

STDIO（默认）：

自定义路径：

无状态HTTP（禁用每个客户端会话状态）：

选项5：Pi编码代理

Pi 不以 MCP 为母语。支持的两条路径：

A. pi-mcp-adapter（推荐——会说MCP，单一真实来源）:

然后在~/.pi/agent/mcp.json中加入：

B. 项目本地扩展（clone + run）: 这个仓库会发布 .pi/extensions/mcp-nixos.ts，当你在克隆仓库中运行 pi 时会自动加载。可选：cd .pi && npm install 用于编辑器类型的分辨率。Pi 无论如何都能运行。

这是什么？

一个MCP服务器，提供准确、实时的信息，内容包括：

• NixOS 软件包 - 实际存在的 130K+ 软件包
• NixOS 选项 - 23K+ 配置系统方式
• Home Manager - 为dotfile爱好者提供5K+选项

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):