> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Uso del servidor MCP de ClickHouse con AnythingLLM

> Esta guía explica cómo configurar AnythingLLM con un servidor MCP de ClickHouse usando Docker.

export const Image = ({img, alt, size = "lg"}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </div>;
};

> Esta guía explica cómo configurar [AnythingLLM](https://anythingllm.com/) con un servidor MCP de ClickHouse usando Docker
> y conectarlo a los conjuntos de datos de ejemplo de ClickHouse.

<Steps>
  <Step title="Instalar Docker" id="install-docker">
    Necesitarás Docker para ejecutar LibreChat y el servidor MCP. Para obtener Docker:

    1. Visita [docker.com](https://www.docker.com/products/docker-desktop)
    2. Descarga Docker Desktop para tu sistema operativo
    3. Instala Docker siguiendo las instrucciones para tu sistema operativo
    4. Abre Docker Desktop y asegúrate de que esté en ejecución

    <br />

    Para más información, consulta la [documentación de Docker](https://docs.docker.com/get-docker/).
  </Step>

  <Step title="Descargar la imagen de Docker de AnythingLLM" id="pull-anythingllm-docker-image">
    Ejecuta el siguiente comando para descargar la imagen de Docker de AnythingLLM en tu máquina:

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

  <Step title="Configurar la ubicación de almacenamiento" id="setup-storage-location">
    Crea un directorio para el almacenamiento e inicializa el archivo de entorno:

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

  <Step title="Configurar el archivo de configuración del servidor MCP" id="configure-mcp-server-config-file">
    Crea el directorio `plugins`:

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

    Crea un archivo llamado `anythingllm_mcp_servers.json` en el directorio `plugins` y agrega el siguiente contenido:

    ```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": ""
          }
        }
      }
    }
    ```

    Si quieres explorar tus propios datos, puedes hacerlo
    usando el [host, nombre de usuario y contraseña](/docs/es/get-started/setup/cloud#connect-with-your-app)
    de tu propio servicio de ClickHouse Cloud.
  </Step>

  <Step title="Iniciar el contenedor de Docker de AnythingLLM" id="start-anythingllm-docker-container">
    Ejecuta el siguiente comando para iniciar el contenedor de Docker de AnythingLLM:

    ```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
    ```

    Una vez iniciado, ve a `http://localhost:3001` en tu navegador.
    Selecciona el modelo que quieres usar y proporciona tu API key.
  </Step>

  <Step title="Esperar a que se inicien los servidores MCP" id="wait-for-mcp-servers-to-start-up">
    Haz clic en el icono de herramientas en la esquina inferior izquierda de la interfaz de usuario:

    <Image img="https://mintcdn.com/private-7c7dfe99/F7iOqwDUBB9E2S65/images/use-cases/AI_ML/MCP/alm_tool-icon.webp?fit=max&auto=format&n=F7iOqwDUBB9E2S65&q=85&s=e5451f3dd897d0102bc2e7cc0d5ea7fc" alt="Icono de herramientas" size="md" width="1025" height="617" data-path="images/use-cases/AI_ML/MCP/alm_tool-icon.webp" />

    Haz clic en `Agent Skills` y busca la sección `MCP servers`.
    Espera hasta que `Mcp ClickHouse` aparezca como `On`

    <Image img="https://mintcdn.com/private-7c7dfe99/F7iOqwDUBB9E2S65/images/use-cases/AI_ML/MCP/allm_mcp-servers.webp?fit=max&auto=format&n=F7iOqwDUBB9E2S65&q=85&s=c073f4fed5e6c7d35d65a63b077335a2" alt="Servidores MCP listos" size="md" width="690" height="933" data-path="images/use-cases/AI_ML/MCP/allm_mcp-servers.webp" />
  </Step>

  <Step title="Chatear con el servidor MCP de ClickHouse en AnythingLLM" id="chat-with-clickhouse-mcp-server-with-anythingllm">
    Ya está todo listo para iniciar un chat.
    Para que los servidores MCP estén disponibles en un chat, tendrás que añadir el prefijo `@agent` al primer mensaje de la conversación.

    <Image img="https://mintcdn.com/private-7c7dfe99/F7iOqwDUBB9E2S65/images/use-cases/AI_ML/MCP/allm_conversation.webp?fit=max&auto=format&n=F7iOqwDUBB9E2S65&q=85&s=33c225adc816cbb72086d17a1dbfe3e8" alt="Conversación" size="md" width="1290" height="1575" data-path="images/use-cases/AI_ML/MCP/allm_conversation.webp" />
  </Step>
</Steps>
