26M13a

Young-Kyoo Kim·2026년 3월 12일

Nexus Proxy를 통해 패키지를 가져올 수 있는 Linux 서버 환경이라면, 굳이 로컬 PC에 툴을 설치할 필요가 없습니다. Linux 서버를 MCP 호환 API 서버로 만들고, 웹 브라우저에서 이를 제어하는 Web-based AI 대시보드를 구축하는 것이 가장 깔끔한 방법입니다.

Air-gap 내 리눅스 서버에서 구축하는 최적의 아키텍처를 안내해 드립니다.

1. 전체 구성도 (Linux Server 중심)

  1. LLM Backend: Ollama (Linux 서버에서 구동)
  2. MCP Servers: Kubernetes, Prometheus 등 (Linux 서버에서 가상환경으로 구동)
  3. AI Orchestrator (Web UI): Open WebUI (Docker/Container로 구동)
  • Open WebUI는 현재 MCP를 공식 지원하여, 웹 화면에서 직접 MCP 서버들을 관리하고 분석 결과를 시각화할 수 있습니다.

2. Linux 서버 구축 단계

① Ollama 및 모델 설치

Nexus를 통해 바이너리를 가져와 설치한 후 모델을 로드합니다.

# 모델 다운로드 (Nexus 프록시 설정이 되어 있다면)
ollama run llama3.1

② MCP 서버 준비 (오프라인 패키징 활용)

Nexus를 통해 필요한 Node.js 또는 Python 패키지를 설치합니다.

# 예: Kubernetes MCP 서버 설치 (npm proxy 설정 필수)
npm install -g @modelcontextprotocol/server-kubernetes

③ Open WebUI 배포 (웹 화면 제공)

사용자는 웹 브라우저를 통해 리눅스 서버의 8080 포트로 접속하게 됩니다. 설치 권한이 제한적이라면 Docker 없이 가상환경으로도 실행 가능합니다.

# Docker 사용 시
docker run -d -p 8080:8080 --add-host=host.docker.internal:host-gateway -v open-webui:/app/data --name open-webui ghcr.io/open-webui/open-webui:main

3. 웹 화면에서 MCP 연동하기

Open WebUI 설정 화면에서 MCP 서버를 등록하면, 채팅 창에서 즉시 AI가 K8s나 Grafana 데이터를 가져올 수 있습니다.

  1. 웹 UI 접속 (http://linux-server-ip:8080)
  2. Settings > Documents/Functions 또는 Workspace 메뉴에서 MCP 설정 섹션으로 이동.
  3. MCP Server 추가:
  • Name: k8s-mcp
  • Type: stdio (리눅스 서버 로컬 명령 실행)
  • Command: npx
  • Args: -y, @modelcontextprotocol/server-kubernetes

4. Observability 3.0 활용 방법

웹 화면 채팅창에 다음과 같이 입력하면 리눅스 서버의 AI가 클러스터를 분석하여 리포트를 보여줍니다.

  • 입력: "현재 에러가 발생 중인 파드 목록을 표로 정리하고, 각 파드의 최근 5분간 로그에서 공통적인 에러 패턴을 분석해줘."
  • AI 동작:
  1. kubernetes MCP 서버를 통해 kubectl get pods 실행.
  2. 에러 파드 확인 후 kubectl logs 실행.
  3. 가져온 로그를 분석하여 웹 화면에 결과 출력.

💡 Air-gap 환경을 위한 팁 (Nexus 활용)

  • Node.js 패키지: .npmrc 파일에 Nexus 주소를 설정하여 npx 명령어가 외부망이 아닌 Nexus를 바라보게 하세요.
  • Python 패키지: pip config set global.index-url 명령어로 Nexus의 PyPI 프록시를 설정하세요.
  • Docker Image: Nexus의 Docker Hosted/Proxy 저장소를 통해 open-webui 이미지를 pull 받으세요.

이렇게 구축하면 사용자는 Windows 환경 제약 없이, 웹 브라우저만으로 강력한 AI 기반 모니터링 환경을 누릴 수 있습니다.

다음 단계로 무엇을 도와드릴까요?

  • "Open WebUI에서 K8s MCP 서버를 등록하는 더 상세한 설정값을 알려줘"
  • "Nexus를 통해 오프라인 환경에서 Ollama 모델 파일을 수동으로 옮기는 법이 궁금해"
  • "AI가 분석한 결과를 Grafana 대시보드 링크와 함께 출력하게 하는 방법이 있어?" 중 선택해 보세요!

===

네, 충분히 가능합니다. 인터넷이 되는 곳에서 필요한 패키지와 의존성을 모두 내려받은 뒤, 그 결과물(바이너리 및 라이브러리)만 압축해서 리눅스 서버로 옮기는 "오프라인 패키징(Sideloading)" 방식을 사용하면 됩니다.

Node.js 기반인 Kubernetes MCP 서버를 에어갭 환경으로 이식하는 구체적인 방법을 정리해 드립니다.

1. 인터넷 가능 환경에서 패키징 (Preparation)

가장 깔끔한 방법은 npm install이 완료된 전체 폴더를 통째로 옮기는 것입니다.

  1. 작업 디렉토리 생성 및 설치:
mkdir k8s-mcp-server && cd k8s-mcp-server
npm init -y
# 전역(-g)이 아닌 현재 폴더에 설치하여 의존성을 가둡니다.
npm install @modelcontextprotocol/server-kubernetes
  1. 번들링 및 압축:
  • node_modules 폴더 안에 모든 실행 로직이 들어있습니다.
  • 해당 폴더 전체를 압축합니다: tar -cvzf k8s-mcp.tar.gz .

2. 에어갭 리눅스 서버로 이관 (Migration)

  1. 압축 파일을 리눅스 서버의 특정 경로(예: /opt/mcp/k8s)에 풀고 권한을 부여합니다.
  2. Node.js 실행 확인: 리눅스 서버에도 node 바이너리는 설치되어 있어야 합니다. (설치 권한이 없다면 Node.js 공식 홈페이지에서 제공하는 node-vXX-linux-x64.tar.xz 바이너리만 받아 압축 풀고 PATH만 걸어주면 됩니다.)

3. Open WebUI와 연동 설정 (Execution)

Open WebUI의 MCP 설정창에서 npx 대신 직접 경로를 지정하여 실행해야 합니다.

  • Command: node
  • Args:
/opt/mcp/k8s/node_modules/@modelcontextprotocol/server-kubernetes/dist/index.js

(참고: 패키지 구조에 따라 dist/index.js 또는 build/index.js일 수 있으니 내부 파일을 확인해 보세요.)

4. 더 쉬운 대안: 단일 바이너리(Single Binary) 활용

만약 Node.js 관리가 번거롭다면, 최근에는 Go나 Rust로 작성된 MCP 서버들이 나오고 있습니다. 이들은 의존성 없이 단일 실행 파일(.exe 또는 바이너리) 하나만 옮기면 바로 작동합니다.

  • 장점: node_modules 수천 개의 파일을 옮길 필요 없이 파일 하나만 복사하면 끝입니다.
  • 방법: GitHub 등에서 mcp-k8s-server 등을 검색하여 Go 기반 바이너리를 내려받아 활용해 보세요.

💡 에어갭 환경 최후의 보루: "커스텀 스크립트 MCP"

정 안 된다면, 파이썬이나 쉘 스크립트로 직접 kubectl 결과를 JSON으로 뱉어주는 초경량 MCP 서버를 직접 짤 수도 있습니다.

# 매우 단순화된 형태의 예시 (mcp_k8s.py)
import json, subprocess, sys

def get_pods():
    result = subprocess.check_output(["kubectl", "get", "pods", "-o", "json"])
    return json.loads(result)

# ... MCP 규격에 맞게 stdio 응답 로직 추가 ...

이 방식은 추가 라이브러리 설치 없이 기존에 설치된 kubectl과 python만으로 AI 모니터링을 구현할 수 있게 해줍니다.

다음 단계로 무엇을 도와드릴까요?

  • "Node.js 없이 실행 가능한 Go 기반의 단일 바이너리 K8s MCP 서버 정보를 찾아줘"
  • "위에서 언급한 파이썬 기반 초경량 MCP 서버 샘플 코드가 필요해"
  • "리눅스 서버에 Node.js 바이너리를 무설치(Portable)로 세팅하는 법을 알려줘" 중 선택해 보세요!

===

profile
Young-Kyoo Kim
engineer
이전 포스트

26M12a

다음 포스트

26M16a

0개의 댓글