퀵 스타트

** 🚨 Nix/NixOS는 필요 없습니다!** Windows, macOS, Linux 등 모든 시스템에서 작동합니다. 그냥 API를 쿼리하는 거예요.

옵션 1: UVX (권장)

옵션 2: 삭제

옵션 3: 도커

이제 당신의 AI는 지어낸 것이 아니라 실제 NixOS 데이터에 접근할 수 있게 되었습니다. 천만에요.

옵션 4: HTTP (원격 MCP)

FastMCP는 HTTP를 통해 이 서버를 실행하며, 이 서버는 URL로 설정되어 있습니다(MCP 엔드포인트는 기본값이 /mcp입니다).

STDIO(기본값):

커스텀 경로:

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

옵션 5: 파이 코딩 에이전트

Pi는 MCP를 모국어로 사용하지 않습니다. 두 가지 지원 경로:

A. pi-mcp-어댑터 (권장 — MCP 발사, 단일 진실의 출처):

그 다음 ~/.pi/agent/mcp.json에 다음을 추가합니다:

B. 프로젝트 로컬 확장 (clone + run): 이 저장소는 .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):