Uso de servidor MCP de ClickHouse con AnythingLLM

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

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.

1. ​

   Instalar Docker

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

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

   
   

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

2. ​

   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
   
3. ​

   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" 
   
4. ​

   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.

5. ​

   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.

6. ​

   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

7. ​

   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.