파이프라인 및 MCP

언어 모델이 단순한 일대일 챗봇 수준을 넘어 독립적 실행력과 비즈니스 활용도를 획득하기 위해서는, 입력 문맥을 제어하고 외부 세계와 유기적으로 소통하는 행동 제어 장치들이 부가되어야 합니다. Open WebUI는 이러한 플러그인 생태계를 완성하기 위해 파이썬 미들웨어인 Pipelines와 표준 연결 프로토콜인 Model Context Protocol(MCP)을 동시 지원합니다.

1Pipelines를 활용한 파이썬 기반 입력·출력 가로채기¶

Pipelines는 사용자의 프롬프트가 로컬 LLM에 도달하기 전(Pre-process), 또는 생성된 답변 텍스트가 사용자 웹 뷰포트에 렌더링되기 전(Post-process) 과정에 깊숙하게 개입할 수 있는 웹 게이트웨이 미들웨어 엔진입니다.

1.1Functions vs Pipelines 아키텍처 비교¶

인프라 성격과 부하 분산 수준에 맞게 선택 가동합니다:

• 내장 Functions (Functions & Filters): Open WebUI 시스템 내부 데이터베이스에 직접 적재되어 경량 훅킹이나 가벼운 정규식 파싱, 단순 텍스트 트리거 처리를 수행합니다. 단일 UI 서버 컨텍스트를 공유하므로 구동이 매우 단순합니다.

• 격리형 Pipelines: 독립적인 파이썬 런타임 환경 및 외부 종속성 라이브러리가 유기적으로 얽힌 computationally heavy 작업(무거운 언어 번역 모델, 외부 백엔드 연동)을 offload하기 위해 별도 도커 서비스(포트 9099)로 물리 격리 구동됩니다. UI 컨테이너의 CPU/GPU 자산 점유와 안정성을 수호하는 최적의 분리 배포 패턴입니다.

1.2밸브(Valves) 구성 제어 및 동적 튜닝¶

파이프라인 소스코드에 API 키나 시스템 민감 변수값을 하드코딩하는 위험을 차단하기 위해 Valves 메커니즘을 지원합니다.

• 파이썬 클래스 정의 시 Valves 변수를 바인딩하면, 관리자 설정 패널에 입력 폼이 자동으로 인터랙티브하게 노출됩니다. 관리자는 가동 중에 번역 API 키나 임계 수치 설정을 웹 UI에서 기민하게 동적 튜닝 및 인가할 수 있습니다.

1.3임의 코드 실행 (Arbitrary Code Execution) 보안 경고¶

2MCP를 통한 외부 데이터베이스 및 파일시스템 제어¶

Model Context Protocol(MCP)은 인공지능 모델이 온프레미스 격리 네트워크 환경 내부의 다양한 외부 자원에 접근하여 도구(Tools)를 사용할 수 있도록 Anthropic이 주도해 제정한 오픈 표준 사양입니다.

Open WebUI는 이 표준 규격을 완벽하게 내재화하여, 모델이 다음과 같은 외부 세계의 액티브 도구들을 즉각 부착하고 가동하게 합니다:

• 로컬 파일시스템 및 내부 자산 탐색: 격리된 가상 공간 내의 문서 구조를 LLM이 직접 리드하고 파악하여 요약 보고서를 작성할 수 있습니다.

• 사내 데이터베이스 다이렉트 쿼리: Postgres, SQLite 등의 사내 RDBMS 접속 커넥터를 도구로 매핑하여 "지난달 부서별 예산 집계 데이터를 조회하고 표로 그려줘"와 같은 오더를 받았을 때 모델이 직접 SQL을 생성하여 그 결과를 시각화해 줍니다.

• 검색 엔진 통합: 격리망 내부에서 자체 검색 허브인 SearXNG나 외부 DuckDuckGo와 동적 정합하여 질의 상황에 맞춰 도구로서 선택 가동합니다.