/ Annuaire / Playground / ClickHouse MCP
● Officiel clickhouse ⚡ Instantané

ClickHouse MCP

par clickhouse · ClickHouse/mcp-clickhouse

Connect ClickHouse columnar database to AI assistants — query analytical workloads through MCP.

ClickHouse MCP is an MCP server maintained by clickhouse. Connect ClickHouse columnar database to AI assistants — query analytical workloads through MCP. See README for installation and configuration: https://github.com/ClickHouse/mcp-clickhouse

Pourquoi l'utiliser

Fonctionnalités clés

Démo en direct

Aperçu en pratique

clickhouse-mcp.replay ▶ prêt
0/0

Installer

Choisissez votre client

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "clickhouse-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-clickhouse"
      ],
      "_inferred": true
    }
  }
}

Ouvrez Claude Desktop → Settings → Developer → Edit Config. Redémarrez après avoir enregistré.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "clickhouse-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-clickhouse"
      ],
      "_inferred": true
    }
  }
}

Cursor utilise le même schéma mcpServers que Claude Desktop. La config projet l'emporte sur la globale.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "clickhouse-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-clickhouse"
      ],
      "_inferred": true
    }
  }
}

Cliquez sur l'icône MCP Servers dans la barre latérale Cline, puis "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "clickhouse-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-clickhouse"
      ],
      "_inferred": true
    }
  }
}

Même format que Claude Desktop. Redémarrez Windsurf pour appliquer.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "clickhouse-mcp",
      "command": "npx",
      "args": [
        "-y",
        "mcp-clickhouse"
      ]
    }
  ]
}

Continue utilise un tableau d'objets serveur plutôt qu'une map.

~/.config/zed/settings.json
{
  "context_servers": {
    "clickhouse-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "mcp-clickhouse"
        ]
      }
    }
  }
}

Ajoutez dans context_servers. Zed recharge à chaud à la sauvegarde.

claude mcp add clickhouse-mcp -- npx -y mcp-clickhouse

Une seule ligne. Vérifiez avec claude mcp list. Supprimez avec claude mcp remove.

Cas d'usage

Usages concrets : ClickHouse MCP

Use ClickHouse MCP for its primary workflow

👤 Claude/MCP client users ⏱ ~20 min intermediate

Quand l'utiliser : See repo README for canonical use cases.

Prérequis
  • Repo cloned or installed — See undefined
Déroulement
  1. Install
    Install ClickHouse MCP per README.✓ Copié
    → Tool registered with client
  2. Configure
    Provide credentials/config as instructed.✓ Copié
    → Successful auth/init
  3. Use
    Run a sample task with ClickHouse MCP.✓ Copié
    → Expected output

Résultat : You can drive the documented workflow end-to-end.

Pièges
  • Skipping README — Read the repo README and CHANGELOG before shipping to prod.

Outils

Ce que ce MCP expose

OutilEntréesQuand appelerCoût
primary see README Primary action free

Coût et limites

Coût d'exécution

Quota d'API
None of its own; bounded by upstream provider quotas if any
Tokens par appel
Depends on usage
Monétaire
Open source — check repo LICENSE
Astuce
Review upstream API costs (if any) before automating.

Sécurité

Permissions, secrets, portée

Portées minimales : Whatever the upstream provider requires
Stockage des identifiants : Env vars or local config — never commit secrets
Sortie de données : Forwards data per its README
Ne jamais accorder : Full admin to untrusted prompts

Dépannage

Erreurs courantes et correctifs

Auth fails

Verify credentials and required scopes match README.

Vérifier : Re-read repo README auth section.
Tool not found by client

Ensure MCP client config points to correct command/path.

Vérifier : Restart the client after editing config.

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills