VOOZH about

URL: https://glama.ai/mcp/servers/utensils/mcp-nixos?locale=ko-KR

⇱ mcp-nixos by utensils | Glama

MCP-NixOS - AI가 패키지 이름을 지어내지 않도록 하세요

👁 CI
👁 codecov
👁 PyPI
👁 FlakeHub
👁 Python 3.11+
👁 CodeRabbit Pull Request Reviews
👁 Built with Claude

빠른 시작

🚨 Nix/NixOS가 필요하지 않습니다! Windows, macOS, Linux 등 모든 시스템에서 작동합니다. 단순히 API를 쿼리하는 방식입니다.

옵션 1: uvx (권장)

👁 Install MCP Server

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

옵션 2: Nix

👁 Install MCP Server

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

옵션 3: Docker

👁 Install MCP Server

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

이제 AI가 내용을 지어내는 대신 실제 NixOS 데이터에 접근할 수 있습니다. 천만에요.

옵션 4: HTTP (원격 MCP)

FastMCP는 URL을 통해 HTTP로 이 서버를 실행하는 것을 지원합니다 (MCP 엔드포인트 기본값은 /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 (기본값):

MCP_NIXOS_TRANSPORT=stdio mcp-nixos

사용자 지정 경로:

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

상태 비저장 HTTP (클라이언트별 세션 상태 비활성화):

MCP_NIXOS_TRANSPORT=http MCP_NIXOS_STATELESS_HTTP=1 mcp-nixos

옵션 5: Pi 코딩 에이전트

Pi는 MCP를 기본적으로 지원하지 않습니다. 두 가지 지원 경로가 있습니다:

A. pi-mcp-adapter (권장 — MCP 지원, 단일 진실 공급원):

pi install npm:pi-mcp-adapter

그런 다음 ~/.pi/agent/mcp.json에 추가하세요:

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

B. 프로젝트 로컬 확장 (복제 + 실행): 이 저장소는 .pi/extensions/mcp-nixos.ts를 제공하며, 복제된 저장소에서 pi를 실행하면 자동으로 로드됩니다. 선택 사항: 에디터 타입 해석을 위해 cd .pi && npm install을 실행하세요. Pi는 어느 쪽이든 실행합니다.

Related MCP server: MCP-Context-Provider

이것은 무엇인가요?

다음 항목에 대한 정확한 실시간 정보를 제공하는 MCP 서버입니다:

  • NixOS 패키지 - 실제로 존재하는 13만 개 이상의 패키지

  • NixOS 옵션 - 시스템을 구성하는 2만 3천 개 이상의 방법

  • Home Manager - 도트파일 애호가를 위한 5천 개 이상의 옵션

  • nix-darwin - Apple이 문서화하지 않은 1천 개 이상의 macOS 설정

  • Nixvim - NuschtOS search를 통한 Neovim 구성용 5천 개 이상의 옵션

  • FlakeHub - FlakeHub.com 레지스트리의 600개 이상의 flake

  • Noogle - noogle.dev를 통한 타입 시그니처가 포함된 2천 개 이상의 Nix 함수

  • NixOS Wiki - wiki.nixos.org의 커뮤니티 문서 및 가이드

  • nix.dev - nix.dev의 공식 Nix 튜토리얼 및 가이드

  • 패키지 버전 - NixHub.io를 통한 커밋 해시가 포함된 과거 버전

  • 바이너리 캐시 상태 - cache.nixos.org에 패키지가 캐시되어 있는지 확인하고 다운로드 크기 확인

  • 로컬 flake 입력 - Nix 저장소에서 직접 고정된 flake 의존성 탐색 (Nix 필요)

도구

단 두 개뿐입니다. AI의 컨텍스트 창은 무한하지 않기 때문에 17개의 도구를 2개로 통합했습니다.

총 약 1,030 토큰. 그게 전부입니다. 다른 MCP 서버들이 블랙 프라이데이처럼 컨텍스트를 독점할 때, 우리는 구석에서 미니멀리스트 차를 마시고 있습니다. AI는 군더더기 없이 NixOS 슈퍼파워를 얻게 됩니다.

nix - 통합 쿼리 도구

모든 것을 제어하는 하나의 도구:

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

작업

기능

search

패키지, 옵션, 프로그램 또는 flake 검색

info

패키지 또는 옵션에 대한 상세 정보 가져오기

stats

개수 및 카테고리 가져오기

options

접두사별로 Home Manager/Darwin 옵션 탐색

channels

사용 가능한 NixOS 채널 나열

flake-inputs

Nix 저장소에서 로컬 flake 입력 탐색

cache

패키지에 대한 바이너리 캐시 상태 확인

소스

쿼리 대상

nixos

패키지, 옵션, 프로그램

home-manager

Home Manager 옵션

darwin

nix-darwin 옵션

flakes

커뮤니티 flake (search.nixos.org)

flakehub

FlakeHub 레지스트리 (flakehub.com)

nixvim

Nixvim Neovim 구성 옵션

noogle

Nix 함수 시그니처 및 문서 (noogle.dev)

wiki

NixOS Wiki 문서 (wiki.nixos.org)

nix-dev

공식 Nix 문서 (nix.dev)

nixhub

패키지 메타데이터 및 저장소 경로 (nixhub.io)

예시:

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

# Get package info
nix(action="info", query="firefox", source="nixos", type="package")

# Search Home Manager options
nix(action="search", query="git", source="home-manager")

# Browse darwin options
nix(action="options", source="darwin", query="system.defaults")

# Search Nixvim options
nix(action="search", query="telescope", source="nixvim")

# Get Nixvim option info
nix(action="info", query="plugins.telescope.enable", source="nixvim")

# Search FlakeHub
nix(action="search", query="nixpkgs", source="flakehub")

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

# Search Noogle for Nix functions
nix(action="search", query="mapAttrs", source="noogle")

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

# Browse Noogle function categories
nix(action="options", source="noogle", query="lib.strings")

# Search NixOS Wiki
nix(action="search", query="nvidia", source="wiki")

# Get Wiki page info
nix(action="info", query="Flakes", source="wiki")

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

# Search NixHub for package metadata
nix(action="search", query="nodejs", source="nixhub")

# Get detailed package info from NixHub (license, homepage, store paths)
nix(action="info", query="python", source="nixhub")

# Check binary cache status
nix(action="cache", query="hello")

# Check cache for specific version
nix(action="cache", query="python", version="3.12.0")

# Check cache for specific system
nix(action="cache", query="firefox", system="x86_64-linux")

# Get stats
nix(action="stats", source="nixos", channel="stable")

# List local flake inputs (requires Nix)
nix(action="flake-inputs", type="list")

# Browse files in a flake input
nix(action="flake-inputs", type="ls", query="nixpkgs:pkgs/by-name")

# Read a file from a flake input
nix(action="flake-inputs", type="read", query="nixpkgs:flake.nix")

nix_versions - 패키지 버전 기록

nixpkgs 커밋 해시와 함께 과거 버전을 찾습니다. 출력에는 다음이 포함됩니다:

  • 사용 가능한 경우 패키지 메타데이터 (라이선스, 홈페이지, 프로그램)

  • 버전별 플랫폼 가용성 (Linux/macOS)

  • 재현 가능한 빌드를 위한 Nixpkgs 커밋 해시

  • Nix 표현식을 위한 속성 경로

nix_versions(package, version, limit)

예시:

# List recent versions with metadata
nix_versions(package="python", limit=5)

# Find specific version
nix_versions(package="nodejs", version="20.0.0")

설치

Nix가 설치되어 있을 필요는 없습니다. Python이 실행되는 곳이라면 어디서든 작동합니다.

# Run directly (no install)
uvx mcp-nixos

# Or install
pip install mcp-nixos

Nix 사용자의 경우:

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

선언적 설치 (NixOS / Home Manager / nix-darwin)

mcp-nixos는 nixpkgs에서 사용할 수 있습니다:

# 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 ];

또는 제공된 오버레이와 함께 flake를 직접 사용하세요:

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

 outputs = { self, nixpkgs, mcp-nixos, ... }: {
 # Example: NixOS configuration
 nixosConfigurations.myhost = nixpkgs.lib.nixosSystem {
 system = "x86_64-linux";
 modules = [{
 nixpkgs.overlays = [ mcp-nixos.overlays.default ];
 environment.systemPackages = [ pkgs.mcp-nixos ];
 }];
 };

 # Example: Home Manager standalone
 homeConfigurations.myuser = home-manager.lib.homeManagerConfiguration {
 pkgs = import nixpkgs {
 system = "x86_64-linux";
 overlays = [ mcp-nixos.overlays.default ];
 };
 modules = [{
 home.packages = [ pkgs.mcp-nixos ];
 }];
 };
 };
}

개발

nix develop # Enter dev shell
nix build # Build package
pytest tests/ # Run tests
ruff check . # Lint
ruff format . # Format
mypy mcp_nixos/ # Type check

감사의 말

  • NixHub.io - 패키지 버전 기록

  • search.nixos.org - 공식 NixOS 검색

  • FlakeHub - Determinate Systems의 Flake 레지스트리

  • Jetify - Devbox 및 NixHub 제작자

  • Noogle - Nix 함수 검색 엔진

  • NuschtOS - Nixvim 지원을 구동하는 정적 옵션 검색 인프라

  • Nixvim - Nix용 Neovim 구성 프레임워크

라이선스

MIT - 공유는 배려이기 때문입니다.

James Brink 제작. Nix를 즐기는 매니아들에 의해 유지 관리됨.

A
license - permissive license
A
quality
B
maintenance

Maintenance

–Maintainers
21hResponse time
3wRelease cycle
15Releases (12mo)
Commit activity
Issues opened vs closed

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/utensils/mcp-nixos'

If you have feedback or need assistance with the MCP directory API, please join our Discord server