很多人第一次把 MCP 数据库服务接上,问模型「库里有几张表」,得到的却是瞎猜或者干脆报错。模型本身看不见你的库,它只能看到 MCP 服务器愿意告诉它的东西。这篇按「谁负责什么」把链路拆开:表结构从哪来、怎么让模型问得到、问不准时先查哪一格,以及哪些暴露方式会顺手把敏感字段带出去。
第一次把 MCP 数据库服务接上,很多人都会顺手问一句「这个库里有哪些表」。结果模型要么一本正经地报出几个根本不存在的表名,要么直接回你「无法访问数据库」。这不是模型笨,是它压根没看见你的库。模型不连数据库,它只读上下文里出现的文字;表名、字段名、类型、注释,全是别人塞进它视野里的。所以你问它表结构,其实是在问 MCP 服务器和客户端:你们到底把它愿意说的话,有没有送到模型嘴边。
这条链路上有三个角色,责任得分清楚。MCP 服务器是唯一真正接触数据库的一方,它执行查询、把结果转成文本;客户端决定哪些工具、哪些返回内容能进入对话;模型只是最后的阅读者。哪一环掉了链子,表现都差不多——模型开始编。下面按「谁负责什么」拆开讲,重点是每节末尾那些能直接动手的动作。
先分清三方的分工,模型天生是瞎子
很多人把 MCP 想成一根直连线:模型接上服务器,服务器接上库,信息自动流通。实际不是。模型每次生成回复前,手里只有一段上下文文本,里面可能有系统提示、你的问题、历史消息,以及工具定义和之前的工具返回结果。它不能主动发起一次数据库连接,也不会在后台偷偷查一下。任何表信息能出现在它眼前,都是被工具调用或资源注入塞进去的。
所以排问题的时候先问一句:这条表信息是哪一步进上下文的?是写在工具描述里,还是模型调了列表工具拿回来的,还是客户端做了资源注入?答不上来,就说明你还没定位到链路。客户端这一环特别容易被忽略——工具确实返回了五十张表,但客户端有截断策略,只把前几张塞进上下文,模型看到的就是那几张,然后很自然地认为库里就这么多。
- 模型
- 只读上下文文本,不连库,看不到任何没被塞进来的表信息
- MCP 服务器
- 真正连库、执行查询、把结果转成文本返回的一方
- 客户端
- 决定哪些工具定义和返回内容进入上下文,截断就发生在这里
- 工具描述
- 模型判断「该不该调这个工具」的唯一依据,写不清楚它就不调
判断标准很简单:如果模型报出的表名你从没在任何工具描述、资源或历史返回里给过它,那就是纯编造,别怀疑数据库权限。反过来,如果它报的表名都真实存在但缺了几张,八成是返回被截断或工具只查了某个 schema。这两种情况改的地方完全不同。
表结构进到模型眼里的四条路
表结构到模型面前,无非四条路,各有各的代价。第一条是写死:把表名和字段直接写进工具描述或系统提示里。模型读工具定义时就知道有哪些表、每个工具能干什么,不用额外调用。好处是稳、省一次往返;坏处是改表就得改配置,表一多描述会膨胀得没法看。库小、表结构稳定的时候这条最省事。
第二条是现场查:单独做一个列表工具、一个列字段工具,模型按需调用,查完再写 SQL。这是最常见也最灵活的做法,代价是多一次工具调用的往返,而且模型得先意识到「我该先查一下」。第三条是资源注入,把整个 schema 当资源一次性贴进上下文,适合表少的小库,表一多直接把上下文挤爆。第四条是靠报错反推——查询报「字段不存在」,模型据此修正。这条只适合兜底,别当主路径,因为模型往往会顺着错误继续猜。
| 方式 | 适合什么情况 | 主要代价 |
|---|---|---|
| 工具描述写死 | 表少、结构稳定、查询频繁 | 改表要同步改配置 |
| 现场调用列表工具 | 表较多、结构会变、需要按需取 | 多一次往返,依赖模型主动调 |
| 资源一次性注入 | 小库、会话内反复查同样几张表 | 表多会挤占上下文 |
| 靠报错反推 | 临时兜底、探索性查询 | 模型容易顺着错误继续猜 |
实际用下来,我建议默认走第二条,关键表再用第一条补。别指望一条路通吃:表少的时候写死省事,表多的时候写死就是负担;全靠现场查,模型偶尔会跳过查询直接写 SQL,然后字段名对不上。
工具怎么切,决定模型问得准不准
工具设计里最常见的错误,是把「列表」和「列字段」塞进同一个工具,一调就返回整库的建表语句。模型确实拿到了全部信息,但上下文也被占满了,后面真正要写 SQL 的时候反而没空间放查询结果。更麻烦的是,这种大返回一旦被客户端截断,模型看到的是一份残缺的 schema,还以为是完整的。
合理切法是分开:一个工具只回表名列表,支持按库或前缀过滤;另一个工具按表名回字段,字段名、类型、是否可空、注释一起给。两个工具都设返回上限,默认只给前若干个字段,超出的让模型再调一次。这样模型能分步取信息,每一步的返回都可控。
- 列表工具只返回表名,别顺手带 DDL,表多的时候这是上下文杀手
- 列字段工具按表名逐个查,一次一张表,返回里带上类型和注释
- 字段注释和枚举含义写进返回文本,否则模型会把状态码当成有意义的取值
- 每个工具的描述里写清「什么时候该调我」,模型靠这句话决定要不要先查
- 返回设条数上限,并在文本里明确写「还有更多,请缩小范围再查」
还有一个细节:字段注释别省。状态字段返回的是数字,没有注释,模型就会拿它当普通数值去比较、去拼条件。注释写清楚「这里是订单状态,取值含义见枚举」,它写出来的 SQL 才靠谱。这跟工具本身对不对没关系,纯粹是给模型的线索够不够。
第一次接上,按这个顺序走一遍
新接一个库,别急着直接问业务问题。先做连通性验证,再做模型行为验证,最后才验证联表能力。顺序反了,出问题时你分不清是连接、权限、工具描述还是模型理解的问题,只能瞎试。
- 手动调一次列表工具在客户端里直接触发列表工具,看返回里有没有表名。空返回先查连接串和账号权限,别往模型身上推。
- 问模型「有哪些表」观察它有没有主动调用列表工具。没调用就回去改工具描述,把「查表结构前必须先调我」写清楚。
- 指定一张小表查字段让它查某张表的字段,验证类型、是否可空、注释有没有一起返回。缺注释就是工具返回里没带。
- 问一个需要联表的业务问题看它是否先查两张表的字段再写 SQL。直接开写且字段名对不上,说明工具描述没建立「先查后写」的习惯。
- 换一个新会话重复一遍排除旧上下文残留的影响。同一会话里改完配置还在原地追问,模型会继续用旧 schema。
模型开始瞎编表名的排查顺序
模型报出不存在的表,先别改提示词。打开客户端日志,看这次对话里工具到底有没有被调用。没调用,是工具描述没让它意识到该查;调用了但返回空,是权限或 schema 范围的问题;调用了也有返回,但模型还是编,那多半是返回被截断,它只看到一部分就当成全部。
截断这事儿挺隐蔽。工具返回了三十张表,客户端按字符数一砍,模型只见到前五张,然后很自信地说「库里有五张表」。你以为它没查,其实查了,只是没看全。先放宽客户端或工具的条数上限,再让它重答一次,对比结果就能确认。还有一种情况是同一个会话里旧 schema 一直留着,你改完表结构没新开会话,模型继续按旧的答。
- 没调工具:改工具描述,写清触发条件和返回内容
- 调了返回空:查账号权限、schema 范围、库名参数有没有传对
- 调了有返回但内容少:查客户端截断策略和工具返回上限
- 返回完整还编:新开会话重试,排除历史消息里的旧 schema 干扰
- 以上都对还错:把模型写的 SQL 拿去手动执行,看是字段名错还是逻辑错
有一种误判值得单独说:有人看到模型不调工具,就去把系统提示写得特别长,反复强调「必须查表」。结果提示词占了大半上下文,工具返回反而被挤掉。这属于治错了地方。工具描述一两句话说清「什么时候调、返回什么」比长提示有效得多。
暴露 schema 的同时也在暴露别的东西
列字段工具是个双刃剑。它让模型知道有哪些字段,也顺手把敏感列名带了出去——手机号、身份证、内部备注这类字段名一旦进了上下文,模型在写查询时就可能把它们选进来,甚至在你的追问下拼出带这些列的 SQL。表结构本身不算机密,但列名加上样例数据就是另一回事了。
控制手段不复杂。生产库只给只读账号,这是底线;更进一步,只挂视图,把敏感列排除在视图外面,模型能看到的就是视图的字段。列字段工具按库或按 schema 限定可见范围,别一个工具把整库 DDL 都吐出来。返回结果里不要带样例数据行,表结构已经够模型写 SQL 了,带一行真实数据就等于顺手泄露了内容。
| 暴露面 | 风险 | 对应做法 |
|---|---|---|
| 敏感列名 | 模型可能把列写进查询 | 只挂视图,敏感列不进视图 |
| 样例数据行 | 真实内容随返回进上下文 | 返回只给结构,不带数据 |
| 整库 DDL | 上下文被占满且范围过大 | 按库或 schema 限定工具可见范围 |
| 写权限账号 | 模型可能生成写操作 | 生产库只给只读账号 |
什么情况下可以不这么严?本地开发库、完全虚构的测试数据,怎么方便怎么来。但只要接的是真实业务数据,上面几条就别省,尤其是只读账号和视图这两条,成本很低,挡住的却是最实在的风险。
多个库或多个环境时怎么不串
接了两个库之后,新的麻烦来了:模型查字段查到了测试库,写 SQL 却发到线上库,同名表字段还不一样,结果报错或者查出驴唇不对马嘴的东西。根子在于很多数据库工具靠「当前连接」的默认库,模型不显式指定库名,服务器就用默认值,而默认值配的是哪个,模型并不知道。
做法是让库名成为工具参数的一部分,每次调用显式传入,工具描述里写清「不传库名会报错」,逼模型明确指定。测试和线上拆成两套服务器配置,别共用一个连接。表特别多的库,按业务域拆成几个服务器,一次暴露几百张表,模型挑表反而挑不准,还不如让它先选域再选表。
还有个容易忽略的点:同名表在不同环境字段不一致时,模型最容易被旧记忆带偏。它可能记得上一次会话里那张表的字段,直接套到这次。改完表结构、换了环境,新开会话是成本最低的规避方式。工具返回里带上库名和环境标识,也能帮模型自己发现对不上。
下一步想知道你正在用的数据库 MCP 服务或中转方案在工具暴露和权限边界上做得怎么样,可以到站内的中转站可信度检测与工具目录里对照着看,把「它到底让模型看到了什么」这件事核清楚再上线。→常见问题
模型说不知道有哪些表,是不是 MCP 没连上?
先别怀疑连接。多数情况是连上了但工具描述里没提表,或者客户端没把工具挂进这次对话。手动调一次列表工具,能返回表名就说明链路是通的,问题在模型这一侧看不看得见。
能不能把整库建表语句一次性贴给模型?
小库可以,表一多就不划算。上下文被 DDL 占满,真正的问题反而没地方放,而且每次改表都得重贴。更稳的是让模型按需调工具查,查哪张拿哪张。
为什么模型查出来的字段和我库里对不上?
常见是会话里留着旧的结构,或者客户端缓存了工具返回。改完表结构新开一个会话再问,另外确认查的是同一个库,测试和线上同名表字段经常不一样。
只读账号够不够安全?
只读只挡住了写操作,字段名本身也是信息。敏感表建议只暴露视图,列字段工具限定可见范围,返回里别带样例数据,这几条比换账号更实际。
表多的时候模型总挑错表怎么办?
按业务域拆服务器,或者在工具描述里写清每张表管什么。一次给几十张带说明的表,比一次给几百张只有名字的表,命中率高得多。