mcp-nixos

MCP-NixOS - AI 비서가 패키지에 대해 환각을 겪어서는 안 되기 때문입니다.

🎉 리팩토링 : 버전 1.0.0은 모든 것을 대폭 간소화하여 완전히 새롭게 작성되었습니다. 복잡한 캐싱, 추상화, 그리고 "엔터프라이즈" 패턴을 모두 제거했습니다. 때로는 덜한 것이 더 좋고, 더 많은 것은 그저 과시일 뿐이기 때문입니다.

빠른 시작(지금 당장 사용하고 싶으시다면)

🚨 Nix/NixOS 필요 없음! 이 도구는 Windows, macOS, Linux 등 모든 시스템에서 작동합니다. 웹 API만 쿼리하면 됩니다.

옵션 1: uvx 사용(대부분 사용자에게 권장)

지엑스피1

옵션 2: Nix 사용(Nix 사용자의 경우)

이제 AI 비서가 NixOS 데이터를 조작하는 대신 실제 데이터에 접근할 수 있습니다. 천만에요.

이건 뭐예요?

MCP-NixOS는 AI 도우미에게 다음에 대한 정확하고 실시간 정보를 제공하는 모델 컨텍스트 프로토콜 서버입니다.

• NixOS 패키지 (실제로 존재하는 패키지 13만 개 이상)
• 구성 옵션 (시스템을 손상시키는 22,000가지 이상의 방법)
• 홈 관리자 설정 (전문 사용자를 위한 4,000개 이상의 옵션)
• nix-darwin 구성 (Apple이 건드리지 않기를 바라는 1,000개 이상의 macOS 설정)
• NixHub.io를 통한 패키지 버전 기록 (커밋 해시가 있는 오래된 Ruby 2.6 찾기)

당신이 실제로 관심을 갖는 도구

🔍 NixOS 도구

• nixos_search(query, type, channel) - 패키지, 옵션 또는 프로그램 검색
• nixos_info(name, type, channel) - 패키지/옵션에 대한 자세한 정보를 얻습니다.
• nixos_stats(channel) - 패키지 및 옵션 수
• nixos_channels() - 사용 가능한 모든 채널 나열
• nixos_flakes_search(query) - 커뮤니티 플레이크 검색
• nixos_flakes_stats() - Flake 생태계 통계

📦 버전 기록 도구(신규!)

• nixhub_package_versions(package, limit) - 커밋 해시를 사용하여 버전 기록을 가져옵니다.
• nixhub_find_version(package, version) - 특정 버전에 대한 스마트 검색

🏠 홈 관리자 도구

• home_manager_search(query) - 사용자 구성 옵션 검색
• home_manager_info(name) - 옵션 세부 정보 받기(제안 포함!)
• home_manager_stats() - 사용 가능한 항목 보기
• home_manager_list_options() - 131개 카테고리 전체 검색
• home_manager_options_by_prefix(prefix) - 접두사로 옵션 탐색

🍎 다윈 도구

• darwin_search(query) - macOS 검색 옵션
• darwin_info(name) - 옵션 세부 정보 가져오기
• darwin_stats() - macOS 구성 통계
• darwin_list_options() - 모든 21개 카테고리 탐색
• darwin_options_by_prefix(prefix) - macOS 옵션 살펴보기

설치 옵션

기억하세요: Nix/NixOS를 설치할 필요가 없습니다! 이 도구는 Python이 실행되는 모든 곳에서 실행됩니다.

일반 사용자(Windows/Mac/Linux)용

Nix 사용자를 위한 (자신이 누구인지 알고 계십니까?)

언급할 가치가 있는 기능

🚀 버전 1.0.0: 대대적인 단순화

• 코드가 대폭 감소 - 수천 줄의 복잡성 제거
• 100% 기능 - 모든 것이 여전히 작동합니다.
• 캐시 손상 0% - 캐시를 완전히 제거했기 때문입니다.
• 상태 비저장 작업 - 정리할 파일 없음
• 직접 API 액세스 - 추상화 불필요

📊 당신이 얻는 것

• 실시간 데이터 - 항상 최신이며 오래되지 않습니다.
• 일반 텍스트 출력 - 사람과 AI가 읽을 수 있음
• 스마트 제안 - 옵션 이름을 잘못 입력할 때 도움이 됩니다.
• 크로스 플랫폼 - Linux, macOS, 그리고 물론 Windows에서도 작동합니다.
• 구성 없음 - 그냥 작동합니다™

🎯 주요 개선 사항

• 동적 채널 해상도 - stable 항상 현재 안정을 가리킴
• 향상된 오류 메시지 - 문제가 발생할 때 실제로 도움이 됩니다.
• 중복 제거된 플레이크 결과 - 더 이상 중복 스팸이 없습니다.
• 버전 인식 검색 - 필요한 이전 Ruby 버전 찾기
• 카테고리 탐색 - 체계적으로 옵션 탐색

개발자를 위한 (용감한 사람들)

닉스(축복받은 길)와 함께

Without Nix (고통의 길)

테스트 철학

• 실제로 사물을 테스트하는 367개의 테스트
• 모의는 겁쟁이를 위한 것이므로 실제 API 호출이 필요합니다.
• XML 누출을 방지하는 일반 텍스트 검증
• Windows 사용자도 고통받을 자격이 있기 때문에 크로스 플랫폼 테스트

환경 변수

딱 하나만. 우리는 이제 미니멀리스트야:

감사의 말

이 프로젝트는 여러 가지 놀라운 서비스에서 데이터를 쿼리합니다.

• NixHub.io - 패키지 버전 기록 및 커밋 추적 제공
• search.nixos.org - 공식 NixOS 패키지 및 옵션 검색
• Jetify - Devbox 및 NixHub 제작자

참고: 해당 서비스에서는 이 도구를 보증하지 않습니다. 저희는 단지 API 사용자로서 감사할 뿐입니다.

특허

MIT - 코드가 아프더라도 공유하는 것은 배려입니다.

제임스 브링크가 만들었고, 닉스를 좋아하는 마조히스트들이 관리하고 있습니다.

역사상 최고이자 최악의 OS를 만들어낸 NixOS 프로젝트에 특별히 감사드립니다.