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

이 가이드에서는 Docker로 AnythingLLM을 ClickHouse MCP 서버와 함께 설정하고 ClickHouse 예제 데이터셋에 연결하는 방법을 설명해요.

출처: 문서

본문

1. Docker 설치

LibreChat과 MCP 서버를 실행하려면 Docker가 필요해요. Docker를 얻으려면:

docker.com 방문
운영체제에 맞는 Docker Desktop 다운로드
운영체제용 지침에 따라 Docker 설치
Docker Desktop을 열고 실행 중인지 확인

자세한 내용은 Docker 문서를 참고해요.

2. AnythingLLM Docker 이미지 가져오기

다음 명령을 실행해 AnythingLLM Docker 이미지를 가져와요.

docker pull anythingllm/anythingllm

3. 저장 위치 설정

스토리지 디렉터리를 만들고 환경 파일을 초기화해요.

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

4. 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 서비스의 호스트, 사용자 이름, 비밀번호를 사용해도 돼요.

5. 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 키를 제공해요.

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

UI 왼쪽 아래의 도구 아이콘을 클릭해요. Agent Skills를 클릭하고 MCP servers 섹션을 봐요. Mcp ClickHouse가 On으로 설정될 때까지 기다려요.

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

이제 채팅을 시작할 준비가 됐어요. 대화에서 MCP 서버를 사용하려면 첫 메시지를 @agent로 시작해야 해요.

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