MCP-серверы / mcp-clickhouse
mcp-clickhouse
4 из последних 5 обновлений изменили то, что читает агент: переписано описаний инструментов — 5, до 0.7.0.
Пакет PyPI · последняя запись 13 ноября 2026 г. на чистой машине с подставными настройками; отправлялся только tools/list. Изменённое описание — не уязвимость. страница на PyPI · Метод и ограничения · эти данные в JSON.
Выпуск за выпуском
0.5.0 → 0.6.0
выпуск minor, 3 сентября 2026 г.list_databases: изменено: схема входных данных
list_tables: изменено: описание и схема входных данных
run_query: изменено: схема входных данных
0.4.1 → 0.5.0
выпуск minor, 1 сентября 2026 г.list_tables: изменено: описание и схема входных данных
run_query: изменено: описание
0.4.0 → 0.4.1
выпуск patch, 17 июля 2026 г.Определения инструментов не изменились.
0.3.0 → 0.4.0
выпуск minor, 3 июня 2026 г.list_databases: изменено: заголовок, аннотации или схема вывода
list_tables: изменено: описание
run_query: изменено: заголовок, аннотации или схема вывода
Проверенные выпуски: 0.3.0 (2026-04-14); 0.4.0 (2026-06-03); 0.4.1 (2026-07-17); 0.5.0 (2026-09-01); 0.6.0 (2026-09-03); 0.7.0 (2026-09-21).
Инструменты в 0.7.0
Отпечаток — это SHA-256 имени, описания и схемы входных данных инструмента, как его записывает verfy.lock. Тот же отпечаток в вашем lock-файле значит, что агент читает ровно это определение. Verfy 0.16.0 и новее фиксирует также заголовок, аннотации и схему вывода, если сервер их отдаёт, поэтому у такого инструмента в вашем lock-файле отпечаток будет другим.
| Инструмент | Описание | Отпечаток |
|---|---|---|
| list_databases | List available ClickHouse databases | c457a294b7a2 |
| list_tables | List available ClickHouse tables in a database, including schema, comment, row count, and column count. Integers outside [-9007199254740991, 9007199254740991] in table metadata are returned as decimal strings. Pagination tokens are single-use and retained for up to one hour. | 53815e4b864d |
| run_query | Execute SQL queries in ClickHouse. Queries run in read-only mode by default. Bind optional params by name with {name:Type} placeholders, such as {name:String} or {vector:Array(Float32)}. Values may be JSON scalars, nulls, or arrays. Pass exact large integers as decimal strings. JSON lists and objects cannot bind to Tuple and Map types. Python percent formatting and $name$ raw binary parameters are not supported. Parameter values stay out of the MCP server's normal SQL log lines, but may appear in errors and backend logs. Set CLICKHOUSE_ALLOW_WRITE_ACCESS=true to allow DDL and DML operations. Set CLICKHOUSE_ALLOW_DROP=true to additionally allow destructive operations (DROP, TRUNCATE, DELETE, UPDATE, REPLACE TABLE/PARTITION, CREATE OR REPLACE, CLEAR COLUMN/INDEX/PROJECTION, DETACH PERMANENTLY). That gate is a best-effort accident guard, not a security boundary. Integers outside [-9007199254740991, 9007199254740991] are returned as decimal strings. Two optional checks also run through this tool. Use DESCRIBE (<query>) when you need a query's output columns and types; it inspects the result schema and surfaces analysis errors such as an unknown column, but a query that describes cleanly can still fail at runtime. Consider EXPLAIN ESTIMATE <query> before a SELECT that could be expensive; it returns the estimated parts, rows and marks read from MergeTree family tables, which is not run time and not result size. Neither runs the query body, though analysis can execute scalar subqueries. | ba37d9a7c1c2 |
Зафиксируйте эти инструменты
Зафиксируйте то, что mcp-clickhouse отдаёт вам сегодня, закоммитьте lock-файл, и pull request провалится, когда инструмент изменится, с текстом до и после. Зафиксируйте и версию пакета в MCP-конфигурации.
$ pip install verfy
$ verfy lock check --update # показывает каждый инструмент и пишет verfy.lock
$ git add verfy.lock# .github/workflows/verfy.yml, после actions/checkout
- uses: verfy-dev/verfy-action@v1Поддерживаете этот сервер? Запускайте ту же проверку на своих выпусках и добавьте значок Locked by Verfy в README.