> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-home-button.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

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

> 이 가이드에서는 Docker를 사용하여 AnythingLLM을 ClickHouse MCP 서버와 함께 설정하는 방법을 설명합니다.

export const Image = ({img, alt, size}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

> 이 가이드에서는 Docker를 사용해 [AnythingLLM](https://anythingllm.com/)을 ClickHouse MCP 서버와 함께 설정하고
> ClickHouse 예시 데이터셋에 연결하는 방법을 설명합니다.

<Steps>
  <Step>
    ## Docker 설치

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

    1. [docker.com](https://www.docker.com/products/docker-desktop)에 접속합니다
    2. 사용 중인 운영 체제에 맞는 Docker Desktop을 다운로드합니다
    3. 운영 체제별 안내에 따라 Docker를 설치합니다
    4. Docker Desktop을 열고 실행 중인지 확인합니다

    <br />

    자세한 내용은 [Docker 문서](https://docs.docker.com/get-docker/)를 참조하십시오.
  </Step>

  <Step>
    ## AnythingLLM Docker 이미지 가져오기

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

    ```bash theme={null}
    docker pull anythingllm/anythingllm
    ```
  </Step>

  <Step>
    ## 스토리지 위치 설정

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

    ```bash theme={null}
    export STORAGE_LOCATION=$PWD/anythingllm && \
    mkdir -p $STORAGE_LOCATION && \
    touch "$STORAGE_LOCATION/.env" 
    ```
  </Step>

  <Step>
    ## MCP 서버 설정 파일 구성

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

    ```bash theme={null}
    mkdir -p "$STORAGE_LOCATION/plugins"
    ```

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

    ```json theme={null}
    {
      "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](/ko/get-started/setup/cloud#connect-with-your-app)를
    사용하면 됩니다.
  </Step>

  <Step>
    ## AnythingLLM Docker 컨테이너 시작

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

    ```bash theme={null}
    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를 입력합니다.
  </Step>

  <Step>
    ## MCP 서버가 시작될 때까지 기다리기

    UI 왼쪽 하단의 도구 아이콘을 클릭합니다.

    <Image img="https://mintcdn.com/private-7c7dfe99-home-button/KSay_cT2LdltZH8Z/images/use-cases/AI_ML/MCP/alm_tool-icon.png?fit=max&auto=format&n=KSay_cT2LdltZH8Z&q=85&s=4ef2e0bd84efc16790fc045c63547116" alt="도구 아이콘" size="md" width="1025" height="617" data-path="images/use-cases/AI_ML/MCP/alm_tool-icon.png" />

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

    <Image img="https://mintcdn.com/private-7c7dfe99-home-button/KSay_cT2LdltZH8Z/images/use-cases/AI_ML/MCP/allm_mcp-servers.png?fit=max&auto=format&n=KSay_cT2LdltZH8Z&q=85&s=12e91f5725d79f433e98fa2b03b9e720" alt="MCP 서버 준비 완료" size="md" width="690" height="933" data-path="images/use-cases/AI_ML/MCP/allm_mcp-servers.png" />
  </Step>

  <Step>
    ## AnythingLLM으로 ClickHouse MCP 서버와 채팅하기

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

    <Image img="https://mintcdn.com/private-7c7dfe99-home-button/KSay_cT2LdltZH8Z/images/use-cases/AI_ML/MCP/allm_conversation.png?fit=max&auto=format&n=KSay_cT2LdltZH8Z&q=85&s=e287b777fd358b10cccfe349c387505e" alt="대화" size="md" width="1290" height="1575" data-path="images/use-cases/AI_ML/MCP/allm_conversation.png" />
  </Step>
</Steps>
