作者 utensils · utensils/mcp-nixos
チャットからNixOSパッケージ、モジュールオプション、Home Manager設定を検索できます。13万以上のパッケージと2万3千以上のオプションに対応し、セットアップ不要です。
mcp-nixosは、NixOSパッケージ、システムオプション、Home Manager、nix-darwin、Nixvim、および関連レジストリを2つのツールで検索します。認証もローカルのNixインストールも不要で、公開検索APIにプロキシします。「Xのパッケージはある？」「Yのオプションは何？」といった質問に、ドキュメントを探し回ることなく回答できます。
%APPDATA%\Claude\claude_desktop_config.json{
"mcpServers": {
"nixos": {
"command": "uvx",
"args": [
"mcp-nixos"
],
"_inferred": true
}
}
}Claude Desktop → Settings → Developer → Edit Config を開く。保存後、アプリを再起動。
{
"mcpServers": {
"nixos": {
"command": "uvx",
"args": [
"mcp-nixos"
],
"_inferred": true
}
}
}Cursor は Claude Desktop と同じ mcpServers スキーマを使用。プロジェクト設定はグローバルより優先。
{
"mcpServers": {
"nixos": {
"command": "uvx",
"args": [
"mcp-nixos"
],
"_inferred": true
}
}
}Cline サイドバーの MCP Servers アイコンをクリックし、"Edit Configuration" を選択。
{
"mcpServers": {
"nixos": {
"command": "uvx",
"args": [
"mcp-nixos"
],
"_inferred": true
}
}
}Claude Desktop と同じ形式。Windsurf を再起動して反映。
{
"mcpServers": [
{
"name": "nixos",
"command": "uvx",
"args": [
"mcp-nixos"
]
}
]
}Continue はマップではなくサーバーオブジェクトの配列を使用。
{
"context_servers": {
"nixos": {
"command": {
"path": "uvx",
"args": [
"mcp-nixos"
]
}
}
}
}context_servers に追加。保存時に Zed がホットリロード。
claude mcp add nixos -- uvx mcp-nixosワンライナー。claude mcp list で確認、claude mcp remove で削除。
使うタイミング： パッケージの大まかな機能は覚えているが、nixの属性名がわからないとき。
結果： configuration.nixやフレークにそのまま記述できる正確な属性。
使うタイミング： zswapを有効にするオプションが「どこかに」あるはずだが、nixpkgsをgrepしたくないとき。
結果： そのまま貼り付けられる正しいオプションの使用例。
使うタイミング： 新しいバージョンで問題が発生し、最後に動作確認済みのコミットに戻したいとき。
nodejs_20の過去のバージョンをコミットハッシュ付きで表示してください。✓ コピーしました結果： ロールバック用の再現可能なピン留めされた入力。
使うタイミング： プログラムを宣言的に管理したいが、どんなオプションがあるかわからないとき。
結果： マニュアル全体を読まずに作成できる動作するHome Manager設定。
オプションを見つけて設定ファイルに書き込む
パッケージが見つからない場合にissueを作成する
foo-cliはnixpkgsにありますか？なければ、フォークリポジトリにGitHub issueを作成してリクエストしてください。✓ コピーしました| ツール | 入力 | 呼び出すタイミング | コスト |
|---|---|---|---|
| nix | action: search|info|stats|options|channels|flake-inputs|cache, args: ... | パッケージ、オプション、チャンネルに関するあらゆるクエリ | 1 upstream API call |
| nix_versions | package: str | 古いバージョンやnixpkgsのピン留めが必要なとき | 1 upstream call |
searchよりも、1つのパッケージに対するinfoを優先してください。uvx not founduvをインストールしてください: curl -LsSf https://astral.sh/uv/install.sh | sh、その後MCPを再追加してください。
uvx --versionNo results for a package I know exists（存在するはずのパッケージで結果が返らない）属性名のスペルが異なる場合があります — より緩いクエリを試すか、説明文で検索してください。
Retry with partial keywordStale version info（バージョン情報が古い）MCPは短時間キャッシュします。5分後に再クエリするか、action=cacheを渡してリフレッシュしてください。
| 代替案 | 代わりに使う場面 | トレードオフ |
|---|---|---|
| search.nixos.org directly | ブラウザのタブで十分な場合 | AIが介在しない |
| nix-search CLI | ローカルで高速に検索したく、Nixがインストール済みの場合 | ローカルのNixと最新のチャンネルが必要 |