用途:为 Pipes 索引器提供部署文档与流程指引,适用于本地 Docker 开发测试、ClickHouse Cloud 生产数据存储、Railway 平台 7×24 托管三种场景,也用于理解部署工作流、配置 MCP 监控与排查部署问题。
主要能力:按部署目标提供专门文档、自动化工作流与 MCP 集成。本地部署支持自动检测/创建 Docker 容器、自动发现 ClickHouse 密码、防止同步表冲突、30 秒数据校验与 MCP 自动配置。ClickHouse Cloud 部署支持部署前连接校验、手动建库、云端错误处理、监控查询生成与分析查询库。Railway 部署支持令牌或登录认证、必须集成 ClickHouse Cloud、通过 Pipes CLI 容器化部署、预检表校验与部署监控。
使用方式:本地先启动 ClickHouse 容器,再在索引器目录执行 bun run dev,约 30 秒后用 clickhouse-client 查询计数验证。Cloud 需先创建服务并配置 CLICKHOUSE_URL、CLICKHOUSE_PASSWORD、CLICKHOUSE_DATABASE,再执行 bun run dev。Railway 需设置 RAILWAY_TOKEN,并执行 npx @iankressin/pipes-cli-test@latest deploy --provider railway,用 railway logs -f 监控。MCP 侧可用 ClickHouse 工具列出数据库/表、执行查询,用 Railway 工具查看服务、日志、变量与部署。
适用场景与限制:建议先本地测试再上云,使用独立数据库避免同步表冲突,部署后 30 秒内检查起始区块与数据质量。Railway 必须使用 ClickHouse Cloud 而非本地 Docker。资料中给出的费用区间、部署耗时与成功率等数据来自原文,实际以官方为准;未提供的细节暂未提供。