mcp-nixos

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 パッケージ(実際に存在するパッケージは 130,000 個以上)
設定オプション（システムを破壊する22,000以上の方法）
ホームマネージャーの設定（パワーユーザー向けの4K以上のオプション）
nix-darwin 構成(Apple がユーザーに触れさせたくない macOS 設定が 1,000 件以上)
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) - コミュニティフレークを検索
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アクセス- 抽象化のナンセンスなし

📊 得られるもの

リアルタイムデータ- 常に最新、決して古くなることはありません
プレーンテキスト出力- 人間とAIが判読可能
スマートな提案- オプション名を間違えたときに役立ちます
クロスプラットフォーム- 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 を楽しむマゾヒストによって管理されています。

史上最高であると同時に最悪の OS を作成した 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