Skip to content

Release history

ClickHouse/mcp-clickhouse releases

ClickHouse database integration with schema inspection and query capabilities

All releases

3 shown

Config change
v0.4.0 Breaking risk
Auth

Exclusive auth + JSON responses

v0.3.0 New feature
⚠ Upgrade required
  • Set CLICKHOUSE_WRITE_ACCESS to enable write‑access mode with built‑in DROP/TRUNCATE protection
  • Use CLICKHOUSE_MCP_MIDDLEWARE to inject custom middleware into the MCP server lifecycle
Notable features
  • SNI override via CLICKHOUSE_SNI environment variable for proxy/load balancer connections
  • Client config override through MCP Context session states enabling runtime connection switching
  • Optional chdb dependency and lazy-load to reduce memory overhead on Windows
Full changelog

What's Changed

  • SNI override support via CLICKHOUSE_SNI environment variable for connections behind proxies or load balancers. (#127)
  • Lazy-load chdb to avoid ~80-100 MB memory overhead when the feature is disabled. (#144)
  • Made chdb an optional dependency for Windows compatibility. (#145)
  • Optional write access mode via CLICKHOUSE_WRITE_ACCESS environment variable, with built-in DROP and TRUNCATE protection. (#93)
  • Client config override support through MCP Context session states, enabling dynamic connection switching at runtime. (#115)
  • Custom middleware injection via CLICKHOUSE_MCP_MIDDLEWARE environment variable for hooking into the MCP server lifecycle. Includes an example middleware module. (#114)

Full Changelog: https://github.com/ClickHouse/mcp-clickhouse/compare/v0.2.0...v0.3.0

v0.2.0 New feature
Notable features
  • Authentication added for HTTP and Server-Sent Events (SSE) transports
Full changelog

What's Changed

  • Add authentication support for HTTP and SSE transports by @joe-clickhouse in https://github.com/ClickHouse/mcp-clickhouse/pull/113

Full Changelog: https://github.com/ClickHouse/mcp-clickhouse/compare/v0.1.13...v0.2.0

Beta — feedback welcome: [email protected]