MCP-NixOS - Because Your AI Assistant Shouldn't Hallucinate About Packages

基本能力

产品定位

MCP-NixOS 是一个为 AI 助手提供准确 NixOS、Home Manager 和 nix-darwin 资源信息的工具，旨在防止 AI 生成关于这些系统的虚假信息。

核心功能

• NixOS 资源：通过 Elasticsearch API 提供包和系统选项
• 支持多个通道：unstable、stable 和特定版本
• 详细的包元数据
• Home Manager：用户配置选项
• 程序、服务和设置
• 分层路径
• nix-darwin：macOS 配置
• 系统默认值、服务和设置
• 智能缓存：减少网络请求，提高启动时间
• 离线工作
• 丰富搜索：快速内存搜索引擎
• 相关选项

适用场景

• AI 助手需要准确 NixOS 信息时
• 开发人员需要快速查找 NixOS 包或系统选项
• macOS 用户使用 nix-darwin 配置

工具列表

• NixOS
• nixos_search(query, type, channel)：搜索包或选项
• nixos_info(name, type, channel)：获取包或选项详情
• nixos_stats(channel)：获取统计信息
• Home Manager
• home_manager_search(query)：搜索配置选项
• home_manager_info(name)：获取选项详情
• home_manager_options_by_prefix(option_prefix)：按前缀获取选项
• nix-darwin
• darwin_search(query)：搜索 macOS 选项
• darwin_info(name)：获取选项详情
• darwin_options_by_prefix(option_prefix)：按前缀获取选项

常见问题解答

• 如何安装？ 使用 pip、uv 或 uvx 安装
• 如何配置？ 在 MCP 配置文件中添加服务器配置
• 缓存位置？ 默认位于 OS 特定的缓存目录

使用教程

使用依赖

确保已安装 Python 和 pip。

安装教程

# 使用 pip 安装
pip install mcp-nixos

# 使用 uv 安装
uv pip install mcp-nixos

# 使用 uvx 运行
uvx --install-deps mcp-nixos

配置

在 ~/.config/claude/config.json 中添加：

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

调试方式

# 运行测试
run-tests

# 运行无覆盖测试
run-tests --no-coverage

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。