用途:lightfast-db 用于查询和检查 Postgres 数据库的 schema 与数据,通过 postgres MCP 服务器访问,所有查询均为只读。当用户询问表、列、行、数据库结构或需要运行 SELECT 查询时触发。
主要能力:postgres MCP 服务器提供 query 工具,用于执行只读 SQL 查询,例如 SELECT、统计行数、检查数据。表结构也以 MCP 资源形式暴露在 postgres://<host>/<table>/schema。
使用方式:检查 schema 时可查询 information_schema.tables 列出所有表、查询 information_schema.columns 查看列定义、查询 pg_indexes 查看索引、查询 information_schema 外键约束查看关系。查询数据时可使用 SELECT * FROM <table> LIMIT 10 采样、SELECT COUNT(*) FROM <table> 计数、SELECT * FROM <table> WHERE <condition> LIMIT 20 过滤。
适用场景:需要了解数据库中有哪些表、表结构、索引、外键关系,或需要查看样本数据、统计行数、按条件筛选数据时。
限制:所有查询在 READ ONLY 事务中运行,INSERT/UPDATE/DELETE 会失败。数据库为 Postgres(PlanetScale Postgres 兼容),通过 SSL 访问。Drizzle schema 定义位于 db/app/src/schema/,需与实际数据库状态交叉参考。迁移使用 pnpm db:generate 和 pnpm db:migrate,不要手写 SQL。