← DeepSeek Harness Plugins
DeepSeek Harness PluginManifest Valid

dsh-clickhouse

Zero-dependency ClickHouse schema exploration and guarded read-only SQL query tools for DeepSeek Harness.

Terminal & TUIDeveloper ToolsRemote Execution
0GitHub Stars0ForksUpdated2026-10-27

Install

$ dsh plugin --profile <profile> add github:<owner>/dsh-clickhouse

Plugin Overview & Capabilities

AI-assisted organization based on the public repository snapshot. The content must be grounded in source evidence and does not replace compatibility or security verification.

source-grounded
dsh-clickhouse provides a suite of seven clickhouse_* tools enabling DeepSeek Harness agents to explore databases, inspect table schemas, sample data, and run guarded read-only SQL queries. It operates with zero runtime dependencies by utilizing Node's built-in fetch API and integrates client-side query sanitization alongside server-side resource caps.

Key Capabilities

  • Database and table catalog exploration with storage size and row count visibility
  • Table schema inspection including data types, default values, and primary/sorting keys
  • Keyword-based column search across tables to locate unfamiliar fields
  • Data row sampling with field projection support
  • Read-only SQL query execution with Markdown and JSON result formatting
  • Client-side guard enforcing single statements and rejecting write operations, external table functions, and file export syntax
  • Server-side resource boundaries including max_result_rows, max_execution_time, and max_memory_usage
  • EXPLAIN query support for plan, estimate, syntax, AST, and pipeline inspection

Useful For

  • Enabling conversational natural language data Q&A over ClickHouse databases in DeepSeek Harness
  • Exploring ClickHouse schemas, table sizes, and column definitions without external database GUIs
  • Running safe ad-hoc analytic queries with strict read-only guarantees and row limits
  • Assisting developers and data analysts in debugging query execution plans and aggregations

Who It Fits

  • Data analysts querying ClickHouse through conversational AI
  • Software engineers needing quick schema inspection inside DeepSeek Harness
  • DeepSeek Harness users requiring safe, sandboxed database exploration

Documented Limitations

  • Client-side SQL guards act as guardrails against mistakes rather than strict database security boundaries; proper database user RBAC is still required
  • Result set is capped by default to 200 rows with a hard limit of 10,000 rows
  • Results are buffered and rendered in memory via JSONCompact, making it unsuitable for massive data exports
  • External table functions and SQL-level SETTINGS are blocked by default unless explicitly configured
  • Non-ASCII aliases require explicit backticks on older ClickHouse versions

DSH Compatibility

Version-specific runtime evidence collected by DSH Plugin. A missing result means we have not tested that combination yet.

Not tested yetNo runtime compatibility tests have been published yet.

Security Signals

Objective signals discovered from package metadata and source inspection. These are not a guarantee that a plugin is safe.

Dependency Counts

package.json declares 0 runtime, 3 development, 0 peer, and 0 optional dependencies.

info
Dsh Bundle Declared

package.json declares DSH bundle metadata.

info
License Declared

GitHub reports the repository license as MIT.

info
Package Manifest Available

A root package.json was captured and can be inspected by the registry.

info
Source Available

Public GitHub source metadata is available for this registry snapshot.

info

Source & Registry Notes

Public provenance, Registry classification, and the latest source check for this entry, kept separate from runtime verification.

Source repository
saichao/dsh-clickhouse
Registry source
GitHub · dsh-plugin topic
Registry classification
Plugin Bundle
Source checked
4f1d236 · 2026-10-27

This project is independently indexed from public source information. DSH Plugin is not affiliated with DeepSeek or the plugin author. Always check the author repository before installation.

Repository Activity

GitHub stars
0GitHub stars
Forks
0
Open issues
0
Last commit
2026-10-27
Last release
No release detected
For maintainers

Maintaining this plugin?

This listing is generated from public repository data. If you maintain this project, you can review the information and share this listing with your users if you find it useful.

Add to README
Listed on DSHPlugin.app