Utiliser le serveur MCP ClickHouse avec AnythingLLM

Ce guide explique comment configurer AnythingLLM avec un serveur MCP ClickHouse à l’aide de Docker et le connecter aux jeux de données d’exemple de ClickHouse.

Installer Docker

Vous aurez besoin de Docker pour exécuter AnythingLLM et le serveur MCP. Pour installer Docker :

Rendez-vous sur docker.com
Téléchargez Docker Desktop pour votre système d’exploitation
Installez Docker en suivant les instructions correspondant à votre système d’exploitation
Ouvrez Docker Desktop et assurez-vous qu’il est en cours d’exécution

Pour plus d’informations, consultez la documentation Docker.

Récupérer l’image Docker AnythingLLM

Exécutez la commande suivante pour récupérer l’image Docker AnythingLLM sur votre machine :

docker pull anythingllm/anythingllm

Définir l’emplacement de stockage

Créez un répertoire de stockage et initialisez le fichier d’environnement :

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

Configurer le fichier de config du serveur MCP

Créez le répertoire plugins :

mkdir -p "$STORAGE_LOCATION/plugins"

Créez un fichier nommé anythingllm_mcp_servers.json dans le répertoire plugins et ajoutez-y le contenu suivant :

{
  "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 vous souhaitez explorer vos propres données, vous pouvez le faire en utilisant le host, username and password de votre propre service ClickHouse Cloud.

Démarrer le conteneur Docker AnythingLLM

Exécutez la commande suivante pour démarrer le conteneur Docker 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

Une fois le démarrage terminé, accédez à http://localhost:3001 dans votre navigateur. Sélectionnez le modèle que vous souhaitez utiliser et indiquez votre API key.

Attendre le démarrage des serveurs MCP

Cliquez sur l’icône d’outil en bas à gauche de l’UI :Cliquez sur Agent Skills et regardez dans la section MCP servers. Attendez que Mcp ClickHouse passe à On

Discuter avec le serveur MCP ClickHouse dans AnythingLLM

Nous sommes maintenant prêts à démarrer une conversation. Pour rendre les serveurs MCP disponibles dans une conversation, vous devrez faire précéder le premier message de @agent.

​Installer Docker

​Récupérer l’image Docker AnythingLLM

​Définir l’emplacement de stockage

​Configurer le fichier de config du serveur MCP

​Démarrer le conteneur Docker AnythingLLM

​Attendre le démarrage des serveurs MCP

​Discuter avec le serveur MCP ClickHouse dans AnythingLLM