AnythingLLM과 함께 ClickHouse MCP 서버 사용하기

이 가이드에서는 Docker를 사용해 AnythingLLM을 ClickHouse MCP 서버와 함께 설정하고 ClickHouse 예시 데이터셋에 연결하는 방법을 설명합니다.

Docker 설치

LibreChat와 MCP 서버를 실행하려면 Docker가 필요합니다. Docker를 설치하려면 다음 단계를 따르세요.

docker.com에 접속합니다
사용 중인 운영 체제에 맞는 Docker Desktop을 다운로드합니다
운영 체제별 안내에 따라 Docker를 설치합니다
Docker Desktop을 열고 실행 중인지 확인합니다

자세한 내용은 Docker 문서를 참조하십시오.

AnythingLLM Docker 이미지 가져오기

다음 명령을 실행하여 AnythingLLM Docker 이미지를 로컬 환경으로 가져옵니다.

docker pull anythingllm/anythingllm

스토리지 위치 설정

스토리지용 디렉터리를 만들고 환경 파일을 초기화합니다.

export STORAGE_LOCATION=$PWD/anythingllm && \
mkdir -p $STORAGE_LOCATION && \
touch "$STORAGE_LOCATION/.env" 

MCP 서버 설정 파일 구성

plugins 디렉터리를 생성합니다.

mkdir -p "$STORAGE_LOCATION/plugins"

plugins 디렉터리에 anythingllm_mcp_servers.json 파일을 만들고 다음 내용을 추가합니다.

{
  "mcpServers": {
    "mcp-clickhouse": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp-clickhouse",
        "--python",
        "3.10",
        "mcp-clickhouse"
      ],
      "env": {
        "CLICKHOUSE_HOST": "sql-clickhouse.clickhouse.com",
        "CLICKHOUSE_USER": "demo",
        "CLICKHOUSE_PASSWORD": ""
      }
    }
  }
}

자체 데이터를 탐색하려면 자신의 ClickHouse Cloud 서비스에 대한 host, username and password를 사용하면 됩니다.

AnythingLLM Docker 컨테이너 시작

다음 명령을 실행하여 AnythingLLM Docker 컨테이너를 시작합니다.

docker run -p 3001:3001 \
--cap-add SYS_ADMIN \
-v ${STORAGE_LOCATION}:/app/server/storage \
-v ${STORAGE_LOCATION}/.env:/app/server/.env \
-e STORAGE_DIR="/app/server/storage" \
mintplexlabs/anythingllm

시작되면 브라우저에서 http://localhost:3001로 이동합니다. 사용할 모델을 선택하고 API Key를 입력합니다.

MCP 서버가 시작될 때까지 기다리기

UI 왼쪽 하단의 도구 아이콘을 클릭합니다.Agent Skills를 클릭한 다음 MCP servers 섹션을 확인합니다. Mcp ClickHouse가 On으로 표시될 때까지 기다립니다.

AnythingLLM으로 ClickHouse MCP 서버와 채팅하기

이제 채팅을 시작할 준비가 되었습니다. 채팅에서 MCP 서버를 사용할 수 있게 하려면 대화의 첫 번째 메시지 앞에 @agent를 붙여야 합니다.

​Docker 설치

​AnythingLLM Docker 이미지 가져오기

​스토리지 위치 설정

​MCP 서버 설정 파일 구성

​AnythingLLM Docker 컨테이너 시작

​MCP 서버가 시작될 때까지 기다리기

​AnythingLLM으로 ClickHouse MCP 서버와 채팅하기