본문으로 바로가기
본문으로 바로가기

AnythingLLM과 함께 ClickHouse MCP 서버 사용

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

Docker 설치​

LibreChat과 MCP 서버를 실행하려면 Docker가 필요합니다. Docker를 설치하려면:

  1. docker.com을 방문합니다
  2. 사용 중인 운영 체제에 맞는 Docker Desktop을 다운로드합니다
  3. 운영 체제에 맞는 안내에 따라 Docker를 설치합니다
  4. 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, 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 키를 입력합니다.

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

UI의 왼쪽 하단에 있는 도구 아이콘을 클릭합니다:

도구 아이콘

Agent Skills를 클릭하고 MCP servers 섹션을 확인합니다. Mcp ClickHouse가 On으로 표시될 때까지 대기합니다

MCP 서버 준비 완료

AnythingLLM으로 ClickHouse MCP 서버와 채팅​

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

대화