Open WebUI와 함께 ClickHouse MCP 서버 사용하기
Open WebUI와 함께 ClickHouse MCP 서버 사용하기
이 가이드에서는 Open WebUI를 ClickHouse MCP 서버와 함께 설정하고 ClickHouse 예제 데이터셋에 연결하는 방법을 설명해요.
출처: 문서
본문
1. uv 설치
이 가이드의 지침을 따르려면 uv를 설치해야 해요. uv를 사용하고 싶지 않다면, MCP 서버 구성을 다른 패키지 관리자로 업데이트해야 해요.
2. Open WebUI 실행
다음 명령으로 Open WebUI를 실행할 수 있어요.
uv run --with open-webui open-webui serve
http://localhost:8080/으로 이동해 UI를 확인해요.
3. ClickHouse MCP 서버 구성하기
ClickHouse MCP 서버를 설정하려면 MCP 서버를 Open API 엔드포인트로 변환해야 해요. 먼저 ClickHouse SQL 플레이그라운드에 연결할 수 있게 해주는 환경 변수를 설정해요.
export CLICKHOUSE_HOST="sql-clickhouse.clickhouse.com"
export CLICKHOUSE_USER="demo"
export CLICKHOUSE_PASSWORD=""
그런 다음 mcpo를 실행해 Open API 엔드포인트를 만들 수 있어요.
uvx mcpo --port 8000 -- uv run --with mcp-clickhouse --python 3.10 mcp-clickhouse
http://localhost:8000/docs로 이동하면 생성된 엔드포인트 목록을 볼 수 있어요. 이 엔드포인트들을 Open WebUI에서 사용하려면 설정으로 이동해야 해요. Tools를 클릭하고, http://localhost:8000을 도구 URL로 추가해요. 완료하면 채팅 표시줄의 도구 아이콘 옆에 1이 보여요. 도구 아이콘을 클릭하면 사용 가능한 도구를 나열할 수 있어요.
4. OpenAI 구성하기
기본적으로 Open WebUI는 Ollama 모델과 함께 동작하지만, OpenAI 호환 엔드포인트도 추가할 수 있어요. 이는 설정 메뉴에서 구성하지만 이번에는 Connections 탭을 클릭해야 해요. 엔드포인트와 OpenAI 키를 추가하면 상단 메뉴에서 OpenAI 모델을 사용할 수 있어요.
5. Open WebUI로 ClickHouse MCP 서버와 채팅하기
이제 대화를 나눌 수 있고, 필요하면 Open WebUI가 MCP 서버를 호출할 거예요.