Qu’est-ce que ClickHouse MCP Server ?
Le serveur MCP ClickHouse est le serveur open source de ClickHouse pour lancer du SQL contre un cluster ClickHouse. Il a trois outils principaux : run_query pour le SQL, list_databases, et list_tables avec des détails de schéma paginés. run_query gère aussi DESCRIBE et EXPLAIN ESTIMATE pour qu'un agent puisse vérifier la sortie d'une requête et les lectures estimées avant de la lancer, et depuis la version 0.7.0 (21 septembre 2026) il accepte des paramètres de requête nommés. Un outil chDB optionnel lance du SQL avec le moteur embarqué de ClickHouse sur des fichiers et des URL.
Installez depuis PyPI (uvx mcp-clickhouse) et définissez les détails de connexion comme CLICKHOUSE_HOST dans l'environnement. Il tourne sur stdio par défaut, ou sur HTTP ou SSE, où il refuse de démarrer sans un jeton bearer, un fournisseur OAuth ou OIDC, ou un refus explicite.
Les clients ClickHouse Cloud ont une seconde option : un serveur distant managé sur https://mcp.clickhouse.cloud/mcp avec 13 outils en lecture seule, connexion OAuth ou par clé d'API, activé par service dans la console Cloud. Le dépôt open source a environ 890 étoiles GitHub et une licence Apache 2.0.
Installer ClickHouse MCP Server
uvx mcp-clickhouseClickHouse MCP Server vaut-il le coup ?
Pour le travail d'analytique, un petit ensemble d'outils est une force. L'agent liste les bases et tables, vérifie une requête avec EXPLAIN ESTIMATE pour voir combien de lignes et de parties elle lirait, puis la lance. Le mode lecture seule est le défaut et est appliqué dans ClickHouse lui-même via readonly=1, pas par analyse du SQL ; activer les écritures prend CLICKHOUSE_ALLOW_WRITE_ACCESS, et DROP, TRUNCATE, DELETE et UPDATE ont besoin d'un second flag, CLICKHOUSE_ALLOW_DROP, en plus.
L'écriture sur la sécurité est exceptionnellement complète. Le mode HTTP refuse de démarrer sans authentification. Le README avertit qu'un fichier .env n'importe où au-dessus du paquet installé peut changer les réglages d'authentification, que les utilisateurs en lecture seule peuvent encore annuler d'autres requêtes tournant sous le même utilisateur, et que la liaison de paramètres n'est pas une fonction de confidentialité parce que les valeurs peuvent encore apparaître dans les logs de requêtes. Il dit clairement que la vérification d'opération destructrice est un garde-fou contre les accidents et que les grants ClickHouse sont la vraie frontière.
La lacune est la taille des résultats. Les requêtes expirent après 30 secondes par défaut, mais une issue ouverte rapporte qu'un SELECT de 3 millions de lignes a renvoyé une charge utile de 231 Mio dans cette fenêtre, assez pour submerger le contexte de n'importe quel modèle. Jusqu'à ce qu'une borne proposée atterrisse, une habitude de LIMIT, un réglage max_result_rows sur l'utilisateur de la base, ou un middleware est le correctif.
L'affirmation antérieure que ClickHouse n'offre aucune option hébergée ne tient plus. Le endpoint managé de ClickHouse Cloud ajoute des outils en lecture seule pour les services, sauvegardes, ClickPipes et une requête de coût d'organisation sur 31 jours, sans rien à installer. Le serveur open source reste celui des clusters autogérés, de chDB, ou des équipes qui veulent un accès en écriture sous leurs propres contrôles.
Là où il fait la différence
Un analyste produit dans une entreprise e-commerce de 50 personnes sur ClickHouse Cloud
Répondre à des questions ad hoc sur les commandes et les tunnels sans écrire de SQL
Connectez Claude au serveur en lecture seule avec un utilisateur ClickHouse dédié, laissez l'agent lister les tables et lancer EXPLAIN ESTIMATE avant chaque SELECT. Le serveur est gratuit ; les requêtes facturent le calcul du service Cloud, à partir d'environ 0,39 $ par unité-heure sur AWS us-east-1 Enterprise.
Un ingénieur plateforme data qui fait tourner ClickHouse autogéré sur Kubernetes
Donner à plusieurs agents internes un accès partagé et authentifié à l'entrepôt
Faites tourner mcp-clickhouse sur HTTP avec un fournisseur OIDC via FastMCP, gardez les écritures désactivées, et ajoutez un middleware qui définit des réglages par tenant. L'isolation des tenants doit encore venir des utilisateurs et rôles ClickHouse.
Un data scientist qui travaille avec des fichiers Parquet sur un portable
Interroger des fichiers locaux et distants avec du SQL sans charger de base de données
Installez mcp-clickhouse[chdb] et activez run_chdb_select_query ; le moteur embarqué lit les fichiers et URL directement. Pas de serveur ni de facture Cloud, mais les requêtes chDB ne portent aucune protection d'écriture côté MCP au-delà de ce que le moteur autorise.
Avant de vous engager
- Mise en route
- uvx mcp-clickhouse avec CLICKHOUSE_HOST, CLICKHOUSE_USER et CLICKHOUSE_PASSWORD dans la configuration du client ; documenté pour Claude Desktop et d'autres clients stdio. Les utilisateurs de ClickHouse Cloud peuvent plutôt activer MCP sur un service et pointer un client vers https://mcp.clickhouse.cloud/mcp.
- Intégrations
- Trois outils (run_query, list_databases, list_tables) plus run_chdb_select_query optionnel. run_query est en lecture seule sauf si les écritures sont activées ; le middleware FastMCP peut intercepter les appels pour la journalisation ou des réglages par utilisateur.
- Données et confidentialité
- Le serveur peut lire tout ce que son utilisateur ClickHouse se voit accordé, alors utilisez un utilisateur dédié au moindre privilège. Il tourne sur votre machine ; rien ne va à ClickHouse l'entreprise sauf si votre base est sur ClickHouse Cloud. Les paramètres de requête peuvent apparaître dans les logs de requêtes ClickHouse.
- Coût à grande échelle
- Le serveur est gratuit. Sur ClickHouse Cloud Enterprise, le calcul va de 0,33 $ à 0,52 $ par unité-heure (8 Gio, 2 vCPU) et le stockage de 22 $ à 27,50 $ par To-mois, selon la région. Les agents qui scannent sans EXPLAIN ESTIMATE peuvent réveiller des services inactifs et brûler du calcul.
- Limites
- Délai d'expiration de requête par défaut de 30 secondes et 10 threads de travail. Pas de plafond sur les lignes renvoyées (issue #223), pas d'outils admin, et pas de mode multi-utilisateur intégré. L'outil de facturation du serveur Cloud hébergé couvre au plus 31 jours par requête.
Les points forts
- Lecture seule par défaut, appliquée côté serveur avec readonly=1
- Opt-in séparé pour DROP, TRUNCATE, DELETE et UPDATE
- EXPLAIN ESTIMATE laisse les agents vérifier le coût avant de lancer
- Le mode HTTP exige un jeton ou OAuth/OIDC
Les points faibles
- Pas de borne sur la taille des résultats ; les grands SELECT peuvent inonder le contexte
- Python et uv nécessaires pour le serveur autogéré
- Pas d'isolation multi-utilisateur ou multi-tenant au-delà des grants ClickHouse
- Le serveur hébergé de Cloud est un produit séparé, en lecture seule
Idéal pour
Les équipes data qui veulent qu'un agent réponde à des questions depuis ClickHouse avec des défauts sûrs.
Alternatives à ClickHouse MCP Server
ClickHouse MCP Server : questions fréquentes
- ClickHouse MCP Server vaut-il le coup ?
- Trois outils et un défaut en lecture seule font de celui-ci un premier serveur de base de données sûr pour un agent d'analytique, pourvu que vous plafonniez vous-même la taille des résultats. Nous lui donnons 4.2 sur 5.
- Combien coûte ClickHouse MCP Server ?
- Gratuit et sous licence Apache-2.0. ClickHouse Cloud est facturé séparément (calcul Enterprise à partir d'environ 0,33 $ par unité-heure de 8 Gio) et offre un essai de 30 jours avec 300 $ de crédits.
- Quels sont les inconvénients de ClickHouse MCP Server ?
- Pas de borne sur la taille des résultats ; les grands SELECT peuvent inonder le contexte; python et uv nécessaires pour le serveur autogéré; pas d'isolation multi-utilisateur ou multi-tenant au-delà des grants ClickHouse; le serveur hébergé de Cloud est un produit séparé, en lecture seule.
- À qui s’adresse ClickHouse MCP Server ?
- Les équipes data qui veulent qu'un agent réponde à des questions depuis ClickHouse avec des défauts sûrs.
- Combien coûte ClickHouse MCP Server pour une équipe ou en production ?
- Le serveur est gratuit. Sur ClickHouse Cloud Enterprise, le calcul va de 0,33 $ à 0,52 $ par unité-heure (8 Gio, 2 vCPU) et le stockage de 22 $ à 27,50 $ par To-mois, selon la région. Les agents qui scannent sans EXPLAIN ESTIMATE peuvent réveiller des services inactifs et brûler du calcul.
- ClickHouse MCP Server est-il sûr pour les données de l’entreprise ?
- Le serveur peut lire tout ce que son utilisateur ClickHouse se voit accordé, alors utilisez un utilisateur dédié au moindre privilège. Il tourne sur votre machine ; rien ne va à ClickHouse l'entreprise sauf si votre base est sur ClickHouse Cloud. Les paramètres de requête peuvent apparaître dans les logs de requêtes ClickHouse.
- Quelles sont les meilleures alternatives à ClickHouse MCP Server ?
- Les alternatives les plus proches que nous avons testées sont Snowflake-managed MCP Server, MCP Toolbox for Databases et Grafana MCP Server.
Réponses vérifiées le 23 oct. 2026.