SuperAPI AI 工具集

pipes-deploy-clickhouse-local

部署与运维

查看项目

更新于 10-16 06:15

技能介绍

用途:该技能面向 Subsquid Pipes 索引器的本地部署,把索引器连接到 Docker 中运行的本地 ClickHouse,用于生产前的本地测试与开发环境搭建。当用户提到“本地测试”“docker”或“本地 ClickHouse”时启用。

主要能力:检查或创建 ClickHouse Docker 容器;验证容器健康;创建数据库;在复用数据库时清理 sync 表;配置索引器 .env;校验迁移与代码中的表名一致性;启动索引器并确认起始区块;30 秒内验证数据流;抽样检查数据质量;配置 MCP 以便查询。

使用方式:先确认 Docker 已安装并运行(docker ps),检查是否已有 ClickHouse 容器(docker ps | grep clickhouse),有则复用、无则创建。随后依次执行:验证连接、创建数据库、必要时 DROP TABLE IF EXISTS $DATABASE_NAME.sync、写入 .env(CLICKHOUSE_URL=http://localhost:8123 等)、比对 schema 与代码表名、用 bun run dev 启动索引器并检查首行日志的起始区块、等待 30 秒统计行数、抽样数据、最后用 claude mcp add 配置 MCP。

适用场景:本地开发、索引器上线前验证、需要本地 ClickHouse 查询与 MCP 接入的调试工作。

限制与注意:资料未提供收费、价格、平台支持范围等信息。需自行准备 Docker、项目路径与起始区块;若起始区块不符需清理 sync 表后重启;端口冲突、认证失败、数据库不存在、30 秒无数据等情况需按故障排查处理。建议为每个索引器使用独立数据库与具名容器,并按需配置卷持久化与资源限制。