MCP-NixOS——因为你的人工智能助手不应该对软件包产生幻觉

🎉 重构：1.0.0 版本彻底重写，彻底简化了一切。我们移除了所有复杂的缓存、抽象和“企业”模式。因为有时候，少即是多，多则只是炫耀。

快速启动（因为您想立即使用它）

**🚨 无需 Nix/NixOS！**此工具适用于任何系统 - Windows、macOS 和 Linux。您只需查询 Web API。

选项 1：使用 uvx（推荐大多数用户使用）

{
  "mcpServers": {
    "nixos": {
      "command": "uvx",
      "args": ["mcp-nixos"]
    }
  }
}

选项 2：使用 Nix（适用于 Nix 用户）

{
  "mcpServers": {
    "nixos": {
      "command": "nix",
      "args": ["run", "github:utensils/mcp-nixos", "--"]
    }
  }
}

就这样。你的 AI 助手现在可以访问真实的 NixOS 数据，而不是凭空捏造。不用客气。

Related MCP server: Notion MCP Server

这是什么东西？

MCP-NixOS 是一个模型上下文协议服务器，可为您的 AI 助手提供有关以下方面的准确实时信息：

• NixOS 软件包（实际存在的软件包超过 13 万个）

• 配置选项（超过 22,000 种破坏系统的方法）

• 家庭管理器设置（高级用户提供 4K+ 选项）

• nix-darwin 配置（Apple 不希望您触碰的 1K+ macOS 设置）

• 通过NixHub.io查看软件包版本历史记录（通过提交哈希值查找古老的 Ruby 2.6）

您真正关心的工具

🔍 NixOS 工具

• nixos_search(query, type, channel) - 搜索包、选项或程序

• nixos_info(name, type, channel) - 获取有关包/选项的详细信息

• nixos_stats(channel) - 软件包和选项计数

• nixos_channels() - 列出所有可用频道

• nixos_flakes_search(query) - 搜索社区 flakes

• nixos_flakes_stats() - Flake 生态系统统计数据

📦 版本历史工具（新！）

• nixhub_package_versions(package, limit) - 使用提交哈希获取版本历史记录

• nixhub_find_version(package, version) ——智能搜索特定版本

🏠 家庭管理工具

• home_manager_search(query) - 搜索用户配置选项

• home_manager_info(name) - 获取选项详细信息（附建议！）

• home_manager_stats() - 查看可用的内容

• home_manager_list_options() - 浏览全部 131 个类别

• home_manager_options_by_prefix(prefix) -按前缀探索选项

🍎 达尔文工具

• darwin_search(query) - 搜索 macOS 选项

• darwin_info(name) - 获取选项详细信息

• darwin_stats() - macOS 配置统计信息

• darwin_list_options() - 浏览全部 21 个类别

• darwin_options_by_prefix(prefix) - 探索 macOS 选项

安装选项

**记住：你不需要安装 Nix/NixOS！**此工具可以在任何 Python 运行的地方运行。

对于普通人（Windows/Mac/Linux）

# Run directly with uvx (no installation needed)
uvx mcp-nixos

# Or install globally
pip install mcp-nixos
uv pip install mcp-nixos

对于 Nix 用户（你知道你是谁）

# Run without installing
nix run github:utensils/mcp-nixos

# Install to profile
nix profile install github:utensils/mcp-nixos

值得一提的功能

🚀 版本 1.0.0：大简化

• 大幅减少代码——删除了数千行复杂的代码

• 100% 功能- 一切仍然有效

• 0% 缓存损坏- 因为我们完全删除了缓存

• 无状态操作——无需清理文件

• 直接 API 访问——无抽象废话

📊 您将获得什么

• 实时数据——始终保持最新，永不过时

• 纯文本输出——人类和人工智能可读

• 智能建议- 在您输入选项名称时提供帮助

• 跨平台——适用于 Linux、macOS，甚至 Windows

• 无需配置- 即可运行™

🎯 关键改进

• 动态通道解析- stable始终指向当前稳定

• 增强的错误信息——当出现问题时确实很有帮助

• 重复数据删除结果- 不再有重复的垃圾邮件

• 版本感知搜索——找到您需要的旧 Ruby 版本

• 类别浏览- 系统地探索选项

对于开发者（勇敢者）

与尼克斯（祝福之路）

nix develop
menu  # Shows all available commands

# Common tasks
run        # Start the server
run-tests  # Run all tests
lint       # Format and check code
typecheck  # Check types

没有尼克斯（痛苦之路）

pip install -e ".[dev]"
pytest tests/
black mcp_nixos/
flake8 mcp_nixos/

测试理念

• 367 个实际测试

• **真正的 API 调用，**因为模拟是懦夫的专利

• 纯文本验证确保没有 XML 泄漏

• 跨平台测试，因为 Windows 用户也应该承受痛苦

环境变量

就一条。我们现在是极简主义者：

致谢

该项目从几个令人惊叹的服务中查询数据：

• NixHub.io - 提供软件包版本历史记录和提交跟踪

• search.nixos.org - 官方 NixOS 软件包和选项搜索

• Jetify —— Devbox和 NixHub 的创造者

注意：这些服务并未认可此工具。我们只是对 API 使用者表示感谢。

执照

MIT——因为分享就是关爱，即使代码会让人痛苦。

由 James Brink 创建，并由喜欢 Nix 的受虐狂维护。

特别感谢 NixOS 项目创建了一个有史以来最好和最坏的操作系统。