技能介绍

问题

数据库接入类工具常把“能连上”当成目标，但真实使用里更常见的是：不知道库里有什么、不确定字段类型、写操作缺少拦截与预览。database-mcp 针对这个场景，把数据库操作拆成一组带边界的 MCP 工具：连接测试、列表、看结构、只读查询、受控写入，适合需要在客户端中直接查库和维护数据的工程师。

工作方式

它提供 connect_db、list_tables、describe_table、query、execute 五个工具。建议按“连接 → 探索 → 查询 → 确认写入”的顺序使用：先用 connect_db 验证主机、端口、账号和库名；再用 list_tables 与 describe_table 了解表和字段；用 query 做只读预览，确认影响范围后再调用 execute。
风险分级是核心约束：SELECT、SHOW、DESCRIBE 等低危语句可直接执行；INSERT、UPDATE、DELETE、RENAME 等中危语句需要显式 confirm: true；DROP、TRUNCATE、ALTER 属于高危，执行前应更加谨慎。配置通过 DB_TYPE、DB_HOST、DB_PORT、DB_USER、DB_PASSWORD、DB_NAME 等环境变量完成，支持 MySQL、MariaDB、TiDB、PostgreSQL、SQLite、Oracle、SQL Server 等类型。查询应使用参数化方式，并只选择必要字段。

适用边界

它适合本地调试、数据库巡检、小批量数据修改和 MCP 客户端集成。生产环境仍应先备份、先预览、后执行；删除操作应带明确 WHERE 条件。若连接失败，检查网络、端口、认证信息和库名；若表不存在，用 list_tables 核对；若参数化失败，核对参数类型与字段类型是否一致。写操作被拦截通常是安全机制，确认无误后再传入确认参数。