mcp-nixos

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 数据，而不是凭空捏造。不用客气。

这是什么东西？

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 用户也应该承受痛苦

环境变量

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

多变的	描述	默认
`ELASTICSEARCH_URL`	NixOS API 端点	https://search.nixos.org/backend

致谢

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

NixHub.io - 提供软件包版本历史记录和提交跟踪
search.nixos.org - 官方 NixOS 软件包和选项搜索
Jetify —— Devbox和 NixHub 的创造者

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

执照

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

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

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

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

View all tools

MCP-NixOS 是一个模型上下文协议服务器，它提供有关 NixOS 包、选项、Home Manager 和 nix-darwin 配置的实时、准确信息，防止 AI 助手对 NixOS 资源产生幻觉，并使其能够提供真实的系统配置指导。

Related Resources

Reddit Discussion about this server

Related MCP Servers

MCP-Guide
qpd-v
A
security
A
license
A
quality
A beginner-friendly Model Context Protocol (MCP) server that helps users understand MCP concepts, provides interactive examples, and lists available MCP servers. This server is designed to be a helpful companion for developers working with MCP. Also comes with a huge list of servers you can install.
Last updated -
3
9
36
JavaScript
Apache 2.0
Sleep MCP Server
Garoth
A
security
F
license
A
quality
A Model Context Protocol (MCP) server that provides a simple sleep/wait tool, useful for adding delays between operations such as waiting between API calls or testing eventually consistent systems.
Last updated -
1
6
7
JavaScript
MCP Maker
CaptainCrouton89
-
security
-
license
-
quality
A specialized server that helps users create new Model Context Protocol (MCP) servers by providing tools and templates for scaffolding projects with various capabilities.
Last updated -
1
TypeScript
MCP API Service
nstanw
-
security
-
license
-
quality
A Model Context Protocol (MCP) server that interacts with system APIs, allowing users to check connections, search employees, register breakfast, and update chemical information by shifts.
Last updated -
2

View all related MCP servers