Intégration du serveur MCP ClickHouse

À quoi sert le serveur MCP « ClickHouse » ?

Le serveur ClickHouse MCP (Model Context Protocol) agit comme un pont robuste reliant les assistants IA et les modèles de langage aux bases de données ClickHouse. En exposant des outils standardisés via MCP, il permet aux développeurs et agents IA d’exécuter des opérations telles que des requêtes SQL, la liste des bases ou l’énumération des tables directement sur un cluster ClickHouse. Cette intégration simplifie les workflows en autorisant l’automatisation IA de l’exploration de base, l’exécution de requêtes et la récupération de données, tout en maintenant la sécurité grâce à des opérations en lecture seule et des variables d’environnement configurables. Le serveur est particulièrement efficace pour enrichir les environnements de développement, automatiser l’analyse de données et fournir un accès programmatique fluide aux capacités avancées de ClickHouse.

Liste des prompts

Aucun modèle de prompt n’est mentionné dans le dépôt ni la documentation.

Liste des ressources

Aucune ressource explicite n’est décrite dans la documentation disponible.

Liste des outils

• run_select_query
  Exécutez des requêtes SQL sur votre cluster ClickHouse en mode lecture seule sécurisé. Accepte une entrée sql (chaîne) représentant la requête SQL à exécuter.

• list_databases
  Liste toutes les bases de données disponibles sur votre cluster ClickHouse.

• list_tables
  Liste toutes les tables d’une base de données spécifiée. Nécessite l’entrée database (chaîne) pour indiquer la base à examiner.

Cas d’usage de ce serveur MCP

• Gestion et exploration de bases de données
  Listez facilement toutes les bases et tables pour comprendre rapidement le schéma et la structure de votre déploiement ClickHouse.

• Exécution automatisée de requêtes
  Exécutez des requêtes SQL en lecture seule par programmation, permettant aux agents IA de récupérer, analyser et résumer des données pour de l’analytique ou du reporting.

• Développement piloté par les données
  Intégrez l’accès aux données en temps réel dans les workflows de développement, pour du prototypage dynamique, la création de dashboards ou des tâches de validation.

• Automatisation analytique sécurisée
  Réalisez des tâches d’analyse avec un accès strictement en lecture, garantissant l’intégrité des données et le respect des politiques de sécurité.

• Intégration avec des agents IA
  Permettez aux assistants IA d’interagir directement avec ClickHouse pour récupérer des données, enrichissant chatbots, assistants ou outils d’automatisation.

Comment l’installer

Windsurf

La documentation ne fournit pas d’instructions d’installation pour Windsurf.

Claude

1. Ouvrez le fichier de configuration Claude Desktop :

   • macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows : %APPDATA%/Claude/claude_desktop_config.json

2. Ajoutez la configuration suivante à la section mcpServers :

   {
     "mcpServers": {
       "mcp-clickhouse": {
         "command": "uv",
         "args": [
           "run",
           "--with",
           "mcp-clickhouse",
           "--python",
           "3.13",
           "mcp-clickhouse"
         ],
         "env": {
           "CLICKHOUSE_HOST": "<clickhouse-host>",
           "CLICKHOUSE_PORT": "<clickhouse-port>",
           "CLICKHOUSE_USER": "<clickhouse-user>",
           "CLICKHOUSE_PASSWORD": "<clickhouse-password>",
           "CLICKHOUSE_SECURE": "true",
           "CLICKHOUSE_VERIFY": "true",
           "CLICKHOUSE_CONNECT_TIMEOUT": "30",
           "CLICKHOUSE_SEND_RECEIVE_TIMEOUT": "30"
         }
       }
     }
   }
   

3. Remplacez les valeurs d’exemple par vos accès ClickHouse réels.

4. Mettez à jour la commande uv avec le chemin absolu de votre exécutable uv.

5. Redémarrez Claude Desktop pour appliquer les modifications.

Exemple pour ClickHouse SQL Playground :

{
  "mcpServers": {
    "mcp-clickhouse": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp-clickhouse",
        "--python",
        "3.13",
        "mcp-clickhouse"
      ],
      "env": {
        "CLICKHOUSE_HOST": "sql-clickhouse.clickhouse.com",
        "CLICKHOUSE_PORT": "8443",
        "CLICKHOUSE_USER": "demo",
        "CLICKHOUSE_PASSWORD": "",
        "CLICKHOUSE_SECURE": "true",
        "CLICKHOUSE_VERIFY": "true",
        "CLICKHOUSE_CONNECT_TIMEOUT": "30",
        "CLICKHOUSE_SEND_RECEIVE_TIMEOUT": "30"
      }
    }
  }
}

Cursor

La documentation ne fournit pas d’instructions d’installation pour Cursor.

Cline

La documentation ne fournit pas d’instructions d’installation pour Cline.

Remarque :
Tous les identifiants ClickHouse doivent être passés via les variables d’environnement dans la section env du JSON de configuration, garantissant que les informations sensibles comme les clés API et mots de passe ne sont pas codées en dur.

Exemple (variables d’environnement pour les identifiants) :

"env": {
  "CLICKHOUSE_HOST": "<clickhouse-host>",
  "CLICKHOUSE_PORT": "<clickhouse-port>",
  "CLICKHOUSE_USER": "<clickhouse-user>",
  "CLICKHOUSE_PASSWORD": "<clickhouse-password>"
}

Comment utiliser ce MCP dans les flux

Utiliser MCP dans FlowHunt

Pour intégrer des serveurs MCP dans votre workflow FlowHunt, commencez par ajouter le composant MCP à votre flux et connectez-le à votre agent IA :

Cliquez sur le composant MCP pour ouvrir le panneau de configuration. Dans la section de configuration du MCP système, insérez les détails de votre serveur MCP avec ce format JSON :

{
  "mcp-clickhouse": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Une fois configuré, l’agent IA peut utiliser ce MCP comme outil et accéder à toutes ses fonctions et capacités. N’oubliez pas de remplacer "mcp-clickhouse" par le nom réel de votre serveur MCP et l’URL par celle de votre propre serveur.

Vue d’ensemble

Notre avis

Le serveur ClickHouse MCP offre une réelle valeur pour les développeurs orientés données souhaitant donner accès à ClickHouse via LLM ou IA. Cependant, le dépôt manque de documentation sur les prompts et ressources, et ne fournit d’installation que pour Claude. Sa boîte à outils est solide pour les requêtes, mais l’absence d’informations sur Roots et Sampling limite sa note pour une évaluation MCP générale.

Score MCP

Note finale :
Sur la base de l’exhaustivité de la documentation, la clarté des outils, la licence ouverte et la traction communautaire, mais compte tenu des sections manquantes sur les prompts, ressources et l’installation multi-plateformes : 6/10