거대언어모델을 연동할 때 가장 큰 걸림돌은 사내 지식의 부재입니다. 직접 구축하기는 까다롭지만 MaxKB 는 RAG 파이프라인과 워크플로우 엔진, MCP 도구를 통합하여 이 문제를 해결합니다.

가볍고 강력한 기술 스택과 아키텍처

MaxKB는 전용 벡터 DB 없이 PostgreSQL 하나로 벡터 검색까지 함께 처리합니다. 백엔드는 Python 기반 Django와 LangChain을 채택했습니다. 프런트엔드는 Vue.js로 매끄러운 사용자 경험을 제공하며 pgvector 확장으로 인프라 구성을 단순화했습니다.

이러한 구조 덕분에 자원 소모가 적고 관리가 수월하여 인프라 비용을 줄입니다. 지능형 고객 상담이나 사내 지식 베이스 구축처럼 데이터 보안이 중요한 환경에서 로컬 인프라에 가볍게 도입하기 좋습니다.

드래그 앤 드롭으로 설계하는 에이전트 워크플로우

웹 기반 캔버스에서 노드를 연결하여 복잡한 비즈니스 흐름을 제어하는 에이전트를 만듭니다. 시작 노드부터 지식 검색, 조건 분기, AI 대화 노드를 마우스로 이어 붙여 동작 흐름을 시각적으로 편리하게 구성합니다. 오른쪽 미리보기 창에서 대화를 바로 테스트하는 기능도 제공합니다.

다양한 모델을 지원하는 유연성도 뛰어납니다. DeepSeek, Llama, Qwen 같은 자체 구축 모델부터 OpenAI, Claude, Gemini, MiniMax 같은 공개 API까지 폭넓게 연동합니다. 텍스트를 넘어 이미지, 오디오, 비디오를 다루는 멀티모달 기능도 기본으로 갖추어 강력한 성능을 발휘합니다.

여기에 MCP 도구 사용 기능까지 결합해 외부 API나 다른 서비스와의 연동성을 극대화했습니다. 단순한 대화형 챗봇을 넘어 실제 업무 시스템과 상호작용하는 에이전트를 손쉽게 구현합니다.

1분 만에 끝나는 Docker 설치와 라이선스 주의점

MaxKB는 Docker 컨테이너 하나로 모든 실행 환경을 구성하여 도입 장벽이 낮습니다. 아래 명령어로 컨테이너를 가동하고 웹 인터페이스로 바로 접속하여 쉽게 시작합니다.

docker run -d --name=maxkb --restart=always -p 8080:8080 -v ~/.maxkb:/opt/maxkb 1panel/maxkb

초기 관리자 계정 정보는 다음과 같습니다.

  1. 접속 주소는 http://your_server_ip:8080 입니다.
  2. 아이디는 admin 입니다.
  3. 초기 비밀번호는 MaxKB@123.. 입니다.

다만 라이선스는 GPL-3.0 조건으로 배포합니다. 내부 소스 코드를 수정해서 외부로 배포할 때는 동일한 라이선스로 전체 소스를 공개해야 하는 카피레프트 의무가 발생합니다. 상업적으로 도입하기 전에 법적 검토를 거치는 편이 안전하므로 주의가 필요합니다.

사내 지식 베이스나 고객 상담 에이전트를 빠르게 검증하고 싶을 때 좋은 선택지입니다. 가볍게 설치하여 테스트해 볼 가치가 충분합니다.

요약

  • PostgreSQL과 pgvector를 활용하여 별도의 전용 벡터 DB 없이도 효율적인 RAG 파이프라인을 구축할 수 있습니다.
  • 노드 기반의 시각적 워크플로우 편집기를 제공하여 복잡한 에이전트 동작 흐름을 코드 없이 유연하게 설계합니다.
  • GPL-3.0 라이선스로 배포되므로 상업적 서비스에 도입하거나 수정본을 배포할 때는 소스 코드 공개 의무를 주의해야 합니다.