クイックスタート

** 🚨 Nix/NixOSは不要!** Windows、macOS、Linuxのどのシステムでも動作します。APIをクエリしているだけです。

オプション1:UVX(推奨)

オプション2:削除

オプション3:Docker

あなたのAIは今や作り話ではなく、実際のNixOSデータにアクセスできるようになりました。どういたしまして。

オプション4:HTTP(リモートMCP)

FastMCPはHTTP上でこのサーバーをHTTP上で実行することをサポートしています(MCPエンドポイントはデフォルトで/mcpです)。

STDIO(デフォルト):

カスタムパス:

ステートレスHTTP(クライアントごとのセッション状態を無効化):

オプション5:Piコーディングエージェント

PiはMCPをネイティブに話すわけではありません。サポートされる2つのパス:

A. pi-mcp-adapter(推奨 — MCPを話す、唯一の真実の情報源):

次に~/.pi/agent/mcp.jsonを加えます:

B. プロジェクトローカル拡張(クローン + 実行): このリポジトリは.pi/extensions/mcp-nixos.tsを出荷し、クローンリポジトリでpiを実行すると自動読み込みされます。オプション:エディタータイプの解像度用にcd .pi && npm install。Piはどちらの方法でも実行します。

これは何?

以下について正確かつリアルタイムな情報を提供するMCPサーバー:

• NixOSパッケージ - 実際に存在する130K+パッケージ
• NixOSオプション- システム設定の23K+方法があります
• ホームマネージャー - ドットファイル愛好家向けの5K+オプション

MCP-NixOS - Because Your AI Shouldn’t Hallucinate Package Names

Quick Start

🚨 No Nix/NixOS Required! Works on any system - Windows, macOS, Linux. You’re just querying APIs.

Option 1: uvx (Recommended)

{
  "mcpServers": {
    "nixos": {
      "command": "uvx",
      "args": ["mcp-nixos"]
    }
  }
}

Option 2: Nix

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

Option 3: Docker

{
  "mcpServers": {
    "nixos": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "ghcr.io/utensils/mcp-nixos"]
    }
  }
}

Your AI now has access to real NixOS data instead of making things up. You’re welcome.

Option 4: HTTP (Remote MCP)

FastMCP supports running this server over HTTP at a URL (the MCP endpoint defaults to /mcp).

# Run an HTTP MCP server at http://127.0.0.1:8000/mcp
MCP_NIXOS_TRANSPORT=http MCP_NIXOS_HOST=127.0.0.1 MCP_NIXOS_PORT=8000 mcp-nixos

STDIO (default):

MCP_NIXOS_TRANSPORT=stdio mcp-nixos

Custom path:

MCP_NIXOS_TRANSPORT=http MCP_NIXOS_PATH=/api/mcp mcp-nixos

Stateless HTTP (disables per-client session state):