MCP-NixOS - Çünkü AI'ınız Paket Adlarını Yanıltmamalı

Hızlı Başlangıç

🚨 Nix/NixOS Gerekli Değil! Herhangi bir sistemde çalışır - Windows, macOS, Linux. Sadece API'leri sorguluyorsunuz.

Seçenek 1: uvx (Önerilen)

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

Seçenek 2: Nix

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

Seçenek 3: Docker

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

Şimdi AI'ınızın gerçek NixOS verileri varken tahminde bulunması yok. Hoşgeldiniz.

Seçenek 4: HTTP (Uzak MCP)

FastMCP bu serveri bir URL'de HTTP üzerinden çalıştırmayı destekler (MCP endpoint varsayılan olarak /mcp'dir).

# HTTP MCP serverini http://127.0.0.1:8000/mcp adresinde çalıştır
MCP_NIXOS_TRANSPORT=http MCP_NIXOS_HOST=127.0.0.1 MCP_NIXOS_PORT=8000 mcp-nixos

STDIO (varsayılan):

MCP_NIXOS_TRANSPORT=stdio mcp-nixos

Özel yol:

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

Stateless HTTP (istemci başına session state'i devre dışı bırakır):

MCP_NIXOS_TRANSPORT=http MCP_NIXOS_STATELESS_HTTP=1 mcp-nixos

Seçenek 5: Pi Coding Agent

Pi natively MCP konuşmaz. İki desteklenen yol:

A. pi-mcp-adapter (önerilen — MCP konuşur, tek kaynak):

pi install npm:pi-mcp-adapter

Sonra ~/.pi/agent/mcp.json'e ekleyin:

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

B. Proje-yerel extension (klonla + çalıştır): bu repo .pi/extensions/mcp-nixos.ts içerir, klonlanan repo'da pi çalıştırdığınızda otomatik yüklenir. İsteğe bağlı: editor tip çözümü için cd .pi && npm install. Pi bunu her iki şekilde de çalıştırır.

Bu Nedir?

Şunlar hakkında doğru, gerçek zamanlı bilgi sağlayan MCP serveri:

• NixOS paketleri - gerçekten var olan 130K+ paket
• NixOS seçenekleri - sisteminizi yapılandırmanın 23K+ yolu
• Home Manager - dotfile meraklıları için 5K+ seçenek
• nix-darwin - Apple'ın belgelemediği 1K+ macOS ayarı
• Nixvim - NuschtOS search üzerinden Neovim yapılandırması için 5K+ seçenek
• FlakeHub - FlakeHub.com registry'sinden 600+ flake
• Noogle - noogle.dev üzerinden type signature'li 2K+ Nix function
• NixOS Wiki - wiki.nixos.org üzerinden topluluk belgeleri ve kılavuzları
• nix.dev - nix.dev üzerinden resmi Nix öğreticileri ve kılavuzları
• Paket sürümleri - NixHub.io üzerinden commit hash'leri olan geçmiş sürümler
• Binary cache durumu - cache.nixos.org'da paketlerin önbelleğe alınıp alınmadığını download büyüklükleriyle kontrol edin
• Yerel flake inputları - Nix store'dan doğrudan sabitlenmiş flake bağımlılıklarını keşfedin (Nix gerekir)

Araçlar

Sadece iki tane. 17 aracı 2'ye birleştirdik çünkü AI'ınızın context window'u sonsuz değil.

Toplam ~1.030 token. Hepsi bu. Diğer MCP serverları context'i Black Friday'miş gibi hoplayıp atarken, biz köşede minimalist çay içiyoruz. AI'ınız NixOS süper güçlerini şişkin olmadan alır.

nix - Birleşik Query Aracı

Hepsine hakim bir araç:

nix(action, query, source, type, channel, limit)

Action	Ne yapar
search	Paketleri, seçenekleri, programları veya flake'leri ara
info	Paket veya seçenek hakkında ayrıntılı bilgi al
stats	Sayı ve kategoriler al
options	Home Manager/Darwin seçeneklerine önekle göz at
channels	Mevcut NixOS kanallarını listele
flake-inputs	Nix store'dan yerel flake inputlarını keşfet
cache	Paketlerin binary cache durumunu kontrol et

Source	Ne sorgular
nixos	Paketler, seçenekler, programlar
home-manager	Home Manager seçenekleri
darwin	nix-darwin seçenekleri
flakes	Topluluk flake'leri (search.nixos.org)
flakehub	FlakeHub registry (flakehub.com)
nixvim	Nixvim Neovim yapılandırma seçenekleri
noogle	Nix function signature'ları ve belgeleri (noogle.dev)
wiki	NixOS Wiki makaleleri (wiki.nixos.org)
nix-dev	Resmi Nix belgeleri (nix.dev)
nixhub	Paket metadatası ve store yolları (nixhub.io)

Örnekler:

# NixOS paketlerini ara
nix(action="search", query="firefox", source="nixos", type="packages")

# Paket bilgisini al
nix(action="info", query="firefox", source="nixos", type="package")

# Home Manager seçeneklerini ara
nix(action="search", query="git", source="home-manager")

# Darwin seçeneklerine göz at
nix(action="options", source="darwin", query="system.defaults")

# Nixvim seçeneklerini ara
nix(action="search", query="telescope", source="nixvim")

# Nixvim seçenek bilgisini al
nix(action="info", query="plugins.telescope.enable", source="nixvim")

# FlakeHub'da ara
nix(action="search", query="nixpkgs", source="flakehub")

# FlakeHub flake bilgisini al
nix(action="info", query="NixOS/nixpkgs", source="flakehub")

# Noogle'da Nix function'larını ara
nix(action="search", query="mapAttrs", source="noogle")

# Noogle function bilgisini al
nix(action="info", query="lib.attrsets.mapAttrs", source="noogle")

# Noogle function kategorilerine göz at
nix(action="options", source="noogle", query="lib.strings")

# NixOS Wiki'de ara
nix(action="search", query="nvidia", source="wiki")

# Wiki sayfa bilgisini al
nix(action="info", query="Flakes", source="wiki")

# nix.dev belgelerde ara
nix(action="search", query="packaging tutorial", source="nix-dev")

# NixHub'da paket metadatası ara
nix(action="search", query="nodejs", source="nixhub")

# NixHub'dan ayrıntılı paket bilgisini al (lisans, homepage, store yolları)
nix(action="info", query="python", source="nixhub")

# Binary cache durumunu kontrol et
nix(action="cache", query="hello")

# Belirli sürüm için cache'i kontrol et
nix(action="cache", query="python", version="3.12.0")

# Belirli sistem için cache'i kontrol et
nix(action="cache", query="firefox", system="x86_64-linux")

# İstatistik al
nix(action="stats", source="nixos", channel="stable")

# Yerel flake inputlarını listele (Nix gerekir)
nix(action="flake-inputs", type="list")

# Flake input'ta dosyalara göz at
nix(action="flake-inputs", type="ls", query="nixpkgs:pkgs/by-name")

# Flake input'tan dosya oku
nix(action="flake-inputs", type="read", query="nixpkgs:flake.nix")

nix_versions - Paket Sürüm Geçmişi

Nixpkgs commit hash'leriyle geçmiş sürümleri bulun. Output şunları içerir:

• Paket metadatası (lisans, homepage, programlar) mevcut olduğunda
• Sürüm başına platform kullanılabilirliği (Linux/macOS)
• Tekrarlanabilir derlemeler için Nixpkgs commit hash
• Nix expression'ları için attribute path

nix_versions(package, version, limit)

Örnekler:

# Son sürümleri metadatalarıyla listele
nix_versions(package="python", limit=5)

# Belirli sürümü bul
nix_versions(package="nodejs", version="20.0.0")

Kurulum

Nix yüklü olmanız GEREKMİYOR. Python çalışan herhangi bir yerde çalışır.

# Doğrudan çalıştır (kurulum yok)
uvx mcp-nixos

# Veya kur
pip install mcp-nixos

Nix kullanıcıları için:

nix run github:utensils/mcp-nixos
nix profile install github:utensils/mcp-nixos

Deklaratif Kurulum (NixOS / Home Manager / nix-darwin)

mcp-nixos nixpkgs'de mevcuttur:

# NixOS (configuration.nix)
environment.systemPackages = [ pkgs.mcp-nixos ];

# Home Manager (home.nix)
home.packages = [ pkgs.mcp-nixos ];

# nix-darwin (darwin-configuration.nix)
environment.systemPackages = [ pkgs.mcp-nixos ];

Veya sağlanan overlay ile doğrudan flake'i kullanın:

# flake.nix
{
  inputs = {
    nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
    mcp-nixos.url = "github:utensils/mcp-nixos";
  };

  outputs = { self, nixpkgs, mcp-nixos, ... }: {
    # Örnek: NixOS yapılandırması
    nixosConfigurations.myhost = nixpkgs.lib.nixosSystem {
      system = "x86_64-linux";
      modules = [{
        nixpkgs.overlays = [ mcp-nixos.overlays.default ];
        environment.systemPackages = [ pkgs.mcp-nixos ];
      }];
    };

    # Örnek: Home Manager bağımsız
    homeConfigurations.myuser = home-manager.lib.homeManagerConfiguration {
      pkgs = import nixpkgs {
        system = "x86_64-linux";
        overlays = [ mcp-nixos.overlays.default ];
      };
      modules = [{
        home.packages = [ pkgs.mcp-nixos ];
      }];
    };
  };
}

Geliştirme

nix develop          # Dev shell'e gir
nix build            # Paketi derle
pytest tests/        # Testleri çalıştır
ruff check .         # Lint
ruff format .        # Format
mypy mcp_nixos/      # Type check

Teşekkürler

• NixHub.io - Paket sürüm geçmişi
• search.nixos.org - Resmi NixOS araması
• FlakeHub - Determinate Systems tarafından Flake registry
• Jetify - Devbox ve NixHub'ın yaratıcıları
• Noogle - Nix function arama motoru
• NuschtOS - Nixvim desteğini destekleyen statik option arama altyapısı
• Nixvim - Nix için Neovim yapılandırma framework'ü

Lisans

MIT - Paylaşmak seviyeyi gösteriyor.

---

James Brink tarafından oluşturdu. Nix'in tadını çıkaran coşku tarafından korunmaktadır.