🎉 重构完成:1.0.0 版本代表了一次彻底的重写,极大地简化了一切。我们移除了所有复杂的缓存、抽象和“企业级”模式。因为有时候,少即是多,而多只是炫耀。
🚨 不需要 Nix/NixOS! 这个工具可以在任何系统上运行——Windows、macOS、Linux。你只是在查询 Web API。
{
"mcpServers": {
"nixos": {
"command": "uvx",
"args": ["mcp-nixos"]
}
}
}

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

就这样。你的 AI 助手现在可以访问真实的 NixOS 数据,而不是编造东西。不客气。
MCP-NixOS 是一个模型上下文协议服务器,为你的 AI 助手提供准确、实时的信息,包括:
nixos_search(query, type, channel)
- 搜索软件包、选项或程序nixos_info(name, type, channel)
- 获取软件包/选项的详细信息nixos_stats(channel)
- 软件包和选项的数量统计nixos_channels()
- 列出所有可用的频道nixos_flakes_search(query)
- 搜索社区 Flakesnixos_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 的地方运行。
# 直接用 uvx 运行(无需安装)
uvx mcp-nixos
# 或者全局安装
pip install mcp-nixos
uv pip install mcp-nixos

# 无需安装直接运行
nix run github:utensils/mcp-nixos
# 安装到 profile
nix profile install github:utensils/mcp-nixos

stable
始终指向当前稳定版nix develop
menu # 显示所有可用命令
# 常见任务
run # 启动服务器
run-tests # 运行所有测试
lint # 格式化并检查代码
typecheck # 检查类型

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

只有一个。我们现在是极简主义者:
变量 | 描述 | 默认值 |
---|---|---|
ELASTICSEARCH_URL |
NixOS API 端点 | https://search.nixos.org/backend |
该项目查询了多个优秀的服务:
注意:这些服务并未认可此工具。我们只是感激的 API 用户。
MIT - 因为分享是关怀,即使代码让人痛苦。
由 James Brink 创建,由享受 Nix 的受虐狂维护。
特别感谢 NixOS 项目,它创造了一个同时是最好的也是最糟糕的操作系统。