Uso de servidor MCP de ClickHouse con AnythingLLM

Esta guía explica cómo configurar AnythingLLM con un servidor MCP de ClickHouse usando Docker y cómo conectarlo a los conjuntos de datos de ejemplo de ClickHouse.

Instalar Docker

Necesitarás Docker para ejecutar LibreChat y el servidor MCP de ClickHouse. Para obtener Docker:

Visita docker.com
Descarga Docker Desktop para tu sistema operativo
Instala Docker siguiendo las instrucciones correspondientes a tu sistema operativo
Abre Docker Desktop y asegúrate de que esté en ejecución

Para más información, consulta la documentación de Docker.

Descargar la imagen de Docker de AnythingLLM

Ejecuta el siguiente comando para descargar la imagen de Docker de AnythingLLM en tu equipo:

docker pull anythingllm/anythingllm

Configurar la ubicación de almacenamiento

Crea un directorio para el almacenamiento e inicializa el archivo de entorno:

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

Configurar el archivo de configuración del MCP server

Crea el directorio plugins:

mkdir -p "$STORAGE_LOCATION/plugins"

Crea un archivo llamado anythingllm_mcp_servers.json en el directorio plugins y añade el siguiente contenido:

{
  "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 de tu propio ClickHouse Cloud service.

Iniciar el contenedor de Docker de AnythingLLM

Ejecuta el siguiente comando para iniciar el contenedor de Docker de AnythingLLM:

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 quieras usar y proporciona tu API key.

Esperar a que se inicien los MCP servers

Haz clic en el icono de herramientas en la esquina inferior izquierda de la interfaz:Haz clic en Agent Skills y busca la sección MCP servers. Espera hasta que veas Mcp ClickHouse en On

Chatear con servidor MCP de ClickHouse usando AnythingLLM

Ya está todo listo para iniciar un chat. Para que los MCP servers estén disponibles en un chat, tendrás que anteponer @agent al primer mensaje de la conversación.

​Instalar Docker

​Descargar la imagen de Docker de AnythingLLM

​Configurar la ubicación de almacenamiento

​Configurar el archivo de configuración del MCP server

​Iniciar el contenedor de Docker de AnythingLLM

​Esperar a que se inicien los MCP servers

​Chatear con servidor MCP de ClickHouse usando AnythingLLM