mcp-nixos云托管模式
githubMCP-NixOS 是一个模型上下文协议服务器，它提供关于 NixOS 软件包、选项、Home Manager 和 nix-darwin 配置的实时、准确信息，防止 AI 助手对 NixOS 资源产生错误想象，并使它们能够提供基于事实的系统配置指导。
By utensils
详情内容
MCP-NixOS - 因为你的AI助手不应该对软件包产生幻觉
🎉 重构完成：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 万个实际存在的软件包）
- 配置选项（超过 2.2 万种方式让你的系统崩溃）
- Home Manager 设置（超过 4 千个选项，适合高级用户）
- nix-darwin 配置（超过 1 千个 macOS 设置，Apple 不希望你碰）
- 软件包版本历史 通过 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)- 搜索社区 Flakesnixos_flakes_stats()- Flake 生态系统的统计信息
📦 版本历史工具（新功能！）
nixhub_package_versions(package, limit)- 获取版本历史并附带提交哈希nixhub_find_version(package, version)- 智能搜索特定版本
🏠 Home Manager 工具
home_manager_search(query)- 搜索用户配置选项home_manager_info(name)- 获取选项详细信息（附带建议！）home_manager_stats()- 查看可用选项home_manager_list_options()- 浏览所有 131 个类别home_manager_options_by_prefix(prefix)- 按前缀探索选项
🍎 Darwin 工具
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）
# 直接用 uvx 运行（无需安装）
uvx mcp-nixos
# 或者全局安装
pip install mcp-nixos
uv pip install mcp-nixos
适合 Nix 用户（你知道你是谁）
# 无需安装直接运行
nix run github:utensils/mcp-nixos
# 安装到 profile
nix profile install github:utensils/mcp-nixos
值得一提的功能
🚀 1.0.0 版本：大简化
- 大幅减少代码 - 移除了数千行复杂代码
- 100% 功能保留 - 一切仍然可用
- 0% 缓存损坏 - 因为我们完全移除了缓存
- 无状态操作 - 无需清理文件
- 直接 API 访问 - 没有抽象的废话
📊 你得到什么
- 实时数据 - 始终最新，永不过时
- 纯文本输出 - 人类和 AI 都可读
- 智能建议 - 当你拼错选项名称时提供帮助
- 跨平台 - 支持 Linux、macOS，甚至 Windows
- 无需配置 - 开箱即用™
🎯 关键改进
- 动态频道解析 -
stable始终指向当前稳定版 - 增强的错误信息 - 当出错时提供实际帮助
- 去重的 Flake 结果 - 不再有重复的垃圾信息
- 版本感知搜索 - 找到你需要的旧 Ruby 版本
- 类别浏览 - 系统地探索选项
给开发者（勇敢的人）
使用 Nix（受祝福的道路）
nix develop
menu # 显示所有可用命令
# 常见任务
run # 启动服务器
run-tests # 运行所有测试
lint # 格式化并检查代码
typecheck # 检查类型
不使用 Nix（痛苦的道路）
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 项目，它创造了一个同时是最好的也是最糟糕的操作系统。
通过SSE URL连接服务
Server已在腾讯云托管，可在连接后免费调用和在线进行工具测试~
工具测试
已支持Server下的18个工具，可选择工具进行在线测试
darwin_info
Get detailed information about a specific nix-darwin option.
Requires an exact option name match. If not found, suggests similar options.
Args:
name: The exact option name (e.g., 'system.defaults.dock.autohide')
Returns:
Plain text with option details (name, type, description) or error with suggestions
darwin_list_options
List all nix-darwin option categories.
Enumerates all top-level categories with their option counts.
Returns:
Plain text list of categories sorted alphabetically with option counts
darwin_options_by_prefix
Get nix-darwin options matching a specific prefix.
Useful for browsing options under a category or finding exact option names.
Args:
option_prefix: The prefix to match (e.g., 'system.defaults' or 'services')
Returns:
Plain text list of options with the given prefix, including descriptions
darwin_search
Search nix-darwin (macOS) configuration options.
Searches through available nix-darwin options by name and description.
Args:
query: The search query string to match against option names and descriptions
limit: Maximum number of results to return (default: 20, max: 100)
Returns:
Plain text list of matching options with name, type, and description
darwin_stats
Get statistics about nix-darwin options.
Retrieves overall statistics including total options, categories, and top categories.
Returns:
Plain text summary with total options, category count, and top 5 categories
home_manager_info
Get detailed information about a specific Home Manager option.
Requires an exact option name match. If not found, suggests similar options.
Args:
name: The exact option name (e.g., 'programs.git.enable')
Returns:
Plain text with option details (name, type, description) or error with suggestions
home_manager_list_options
List all Home Manager option categories.
Enumerates all top-level categories with their option counts.
Returns:
Plain text list of categories sorted alphabetically with option counts
home_manager_options_by_prefix
Get Home Manager options matching a specific prefix.
Useful for browsing options under a category or finding exact option names.
Args:
option_prefix: The prefix to match (e.g., 'programs.git' or 'services')
Returns:
Plain text list of options with the given prefix, including descriptions
home_manager_search
Search Home Manager configuration options.
Searches through available Home Manager options by name and description.
Args:
query: The search query string to match against option names and descriptions
limit: Maximum number of results to return (default: 20, max: 100)
Returns:
Plain text list of matching options with name, type, and description
home_manager_stats
Get statistics about Home Manager options.
Retrieves overall statistics including total options, categories, and top categories.
Returns:
Plain text summary with total options, category count, and top 5 categories
nixhub_find_version
Find a specific version of a package in NixHub with smart search.
Automatically searches with increasing limits to find the requested version.
Args:
package_name: Name of the package to query (e.g., "ruby", "python")
version: Specific version to find (e.g., "2.6.7", "3.5.9")
Returns:
Plain text with version info and commit hash if found, or helpful message if not
nixhub_package_versions
Get version history and nixpkgs commit hashes for a specific package from NixHub.io.
Use this tool when users need specific package versions or commit hashes for reproducible builds.
Args:
package_name: Name of the package to query (e.g., "firefox", "python")
limit: Maximum number of versions to return (default: 10, max: 50)
Returns:
Plain text with package info and version history including commit hashes
nixos_channels
List available NixOS channels with their status.
Returns:
Plain text list showing channel names, versions, and availability
nixos_flakes_search
Search NixOS flakes by name, description, owner, or repository.
Searches the flake index for community-contributed packages and configurations.
Flakes are indexed separately from official packages.
Args:
query: The search query (flake name, description, owner, or repository)
limit: Maximum number of results to return (default: 20, max: 100)
channel: Ignored - flakes use a separate indexing system
Returns:
Plain text list of unique flakes with their packages and metadata
nixos_flakes_stats
Get statistics about available NixOS flakes.
Retrieves statistics from the flake search index including total packages,
unique repositories, flake types, and top contributors.
Returns:
Plain text summary with flake statistics and top contributors
nixos_info
Get detailed info about a NixOS package or option.
Args:
name: Name of the package or option to look up
type: Type of lookup - "package" or "option"
channel: NixOS channel to search in (e.g., "unstable", "stable", "25.05")
Returns:
Plain text details about the package/option or error message
nixos_search
Search NixOS packages, options, or programs.
Args:
query: Search term to look for
search_type: Type of search - "packages", "options", "programs", or "flakes"
limit: Maximum number of results to return (1-100)
channel: NixOS channel to search in (e.g., "unstable", "stable", "25.05")
Returns:
Plain text results with bullet points or error message
nixos_stats
Get NixOS statistics for a channel.
Args:
channel: NixOS channel to get stats for (e.g., "unstable", "stable", "25.05")
Returns:
Plain text statistics including package/option counts
腾讯云开发者
