Repolode
utensils

utensils/mcp-nixos

为 AI 助手提供实时、准确的 NixOS 包、选项与 Home Manager 等 Nix 资源查询的 MCP 服务器。

Star
864
Fork
46
未关闭 Issue
1
最近提交
2个月前

这是什么?

MCP-NixOS 是一个基于 Model Context Protocol 的服务器,让 Claude 等 AI 助手直接查询 NixOS 数据,从而查到真实存在的包名和配置选项,而不是凭空猜测。它覆盖 NixOS 包与选项、Home Manager、nix-darwin、Nixvim、NVF、FlakeHub、Noogle、NixOS Wiki、nix.dev,并可通过 NixHub 查询包的历史版本,还能检查二进制缓存状态。

服务器只提供两个工具:统一的 `nix` 工具支持 search、info、stats、browse、cache 等操作;`nix_versions` 工具则返回包的历史版本及对应的 nixpkgs commit hash。默认使用 STDIO 传输,也支持 HTTP,可通过 uvx、pip、Nix 或 Docker 启动。查询远程数据源无需安装 Nix,但浏览本地 flake 输入和 store 路径需要 Nix。

核心功能

  • 01搜索 NixOS 包、选项和程序,并支持 Home Manager 与 nix-darwin 选项。
  • 02通过 Nixvim 和 NVF 查询 Neovim 配置选项。
  • 03查询 Noogle 函数签名、NixOS Wiki 文章和 nix.dev 文档。
  • 04查找包的历史版本及对应的 nixpkgs commit hash。
  • 05检查 cache.nixos.org 上的二进制缓存状态及下载大小。
  • 06支持 STDIO 与 HTTP 传输,可通过 uvx、pip、Nix 或 Docker 安装。

适用场景

  • 让 AI 助手编写 NixOS 或 Home Manager 配置时使用正确的选项名。
  • 在加入配置前确认某个包是否存在,并查到正确的属性名。
  • 通过查找 nixpkgs commit hash 锁定某个旧版本的包。
  • 编写 Nix 代码时查询库函数及其类型签名。

快速上手

  1. 1

    在你的 MCP 客户端中添加基于 uvx 的服务器配置

  2. 2

    或使用 pip 安装该包

    pip install mcp-nixos

使用前须知

  • 仅 flake-inputs 和 store 操作需要安装 Nix;其余功能通过公共 API 查询。

标签

常见问题

mcp-nixos 是什么?
为 AI 助手提供实时、准确的 NixOS 包、选项与 Home Manager 等 Nix 资源查询的 MCP 服务器。 MCP-NixOS 是一个基于 Model Context Protocol 的服务器,让 Claude 等 AI 助手直接查询 NixOS 数据,从而查到真实存在的包名和配置选项,而不是凭空猜测。它覆盖 NixOS 包与选项、Home Manager、nix-darwin、Nixvim、NVF、FlakeHub、Noogle、NixOS Wiki、nix.dev,并可通过 NixHub 查询包的历史版本,还能检查二进制缓存状态。
mcp-nixos 可以免费使用吗?用的什么许可证?
mcp-nixos 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
mcp-nixos 还在维护吗?
半年内有更新。mcp-nixos 最近一次提交是在 2026年9月5日。
mcp-nixos 适合用来做什么?
让 AI 助手编写 NixOS 或 Home Manager 配置时使用正确的选项名。 在加入配置前确认某个包是否存在,并查到正确的属性名。 通过查找 nixpkgs commit hash 锁定某个旧版本的包。 编写 Nix 代码时查询库函数及其类型签名。
mcp-nixos 怎么安装和运行?
在你的 MCP 客户端中添加基于 uvx 的服务器配置 或使用 pip 安装该包: pip install mcp-nixos
在哪里获取 mcp-nixos?
源代码和安装说明在 GitHub 上:https://github.com/utensils/mcp-nixos

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目