接 MCP 数据库服务器时,最容易卡住的一步是:模型根本不知道库里有哪些表,问它查订单它却编了个表名。这不是模型笨,而是表结构信息没进它的上下文。这篇把几种常见做法摆出来——写死在工具描述里、启动时枚举、让模型自己调工具问——并给出按库大小选路子的判断标准,以及表多、权限窄、字段名乱时的绕行办法。
接 MCP 数据库服务器时,最容易卡住的一步往往不是连接失败,而是模型根本不知道库里有哪些表。你让它查订单,它回你一个不存在的表名;你让它按客户号筛选,它猜了个字段叫 customer_id,实际库里叫 cust_no。这不是模型笨,而是表结构信息压根没进它的上下文。
关键要建立这个认知:模型只认上下文里的文字,数据库对它是个黑盒。MCP 服务器连上库,只是把「通道」打通了,服务器喂给模型什么,模型才知道什么。所以「怎么让模型知道有哪些表」本质是个信息投喂问题,不是模型能力问题。下面按「为什么看不见 → 四条投喂路子 → 怎么按库选 → 工具怎么设计 → 元数据从哪取 → 权限收口 → 排查顺序」讲一遍。
模型天生看不见你的库
很多人第一次配 MCP 数据库服务器时会默认:连上了,模型就自动懂表结构了。实际不是。服务器进程能读库,但模型只能看到服务器以工具描述、系统提示或工具返回结果形式递给它的那部分文字。没被写进上下文的表名和字段,模型一律不知道,只能靠语义猜。
判断信息有没有进去,看模型错的方式就能推断。表名靠编、字段名靠猜、动不动就给查询加 LIMIT、把结构相似的两张表混着用,这几种表现基本都指向同一个原因:它手里只有表名的一个模糊印象,没有字段清单。
- 表现一:编表名。问它查订单,它给你 orders,实际叫 t_order_main,说明它连表名列表都没拿到
- 表现二:猜字段。表对了但字段全错,说明只喂了表名没喂字段
- 表现三:乱加 LIMIT 或乱套分页,说明它不确定数据量,只能保守处理
- 表现四:把相似表混用,比如把历史表和当前表当成一张,说明没有表级注释帮它区分
让模型知道表结构的四条路
把表结构送进模型上下文,常见就四条路,各有适用边界。选哪条不看哪条高级,看你的库多大、变得多快、模型要答的问题有多深。
| 做法 | 怎么落地 | 适合什么库 | 主要代价 |
|---|---|---|---|
| 写死在工具描述 | 把表名和字段清单写进工具 description | 表少于十几张、结构稳定的小库 | 改表要同步改描述,容易忘 |
| 启动时全量枚举 | 服务器连库后查元数据,把结果拼进系统提示 | 中小库、一次看全省往返 | 表一多就吃满上下文、稀释重点 |
| 按需查询 | 只给「列出表」「看表结构」两个工具,让模型自己问 | 表多、问题集中在少数几张表 | 多一轮往返,模型得会主动调用 |
| 外部文档注入 | 数据字典做成一页 Markdown,按问题召回再塞上下文 | 字段含义复杂、注释缺失的库 | 要先维护一份可信的字典,和库同步是额外工作 |
这四条不是互斥的。常见组合是:小库启动时全量枚举打底,再补一个按需查表结构的工具兜底;大库则反过来,平时只给目录和按需工具,碰到高频表再单独把它的字段写进提示。
按库的大小和变更频率选路子
选路子的核心变量就两个:表的数量和结构变更频率。把这两个想清楚,选型就不纠结了。
- 先数表连库跑一遍元数据查询,数出业务表总数。十几张以内走全量枚举,几十上百张必须先做分类目录再按需展开。
- 再看变更频率结构一周改几次的库,任何静态快照都会过期,得把枚举做成启动时刷新或加个重载工具,别写死在提示里。
- 再看字段质量字段名是英文缩写、注释又缺的库,光喂表名没用,得把字段含义一并喂进去,否则模型照样猜错字段。
- 最后定兜底无论选哪条,都留一个「按需查表结构」的工具当兜底,模型卡住时能自己补信息。
如果你的库版本和元数据读取方式拿不准,可以到 /guides 翻一下工具接入相关的说明,核对当下可用的做法。
工具怎么设计,模型才用得顺
同样是把表结构告诉模型,工具设计的差别会直接影响它用得准不准。核心原则:一件事一个工具,返回结构化,错误可读。
- 把「有哪些表」和「某张表长什么样」拆成两个工具,别塞进一个万能查询接口,模型才能分步取信息
- 返回结构化字段:表名、字段名、类型、是否可空、一句注释,比一段自然语言描述更好解析
- 加只读白名单,屏蔽系统库、日志表和临时表,避免模型翻出一堆无关内容
- 错误返回要可读:表不存在时把相近表名回给模型,它下一轮能自己纠正,别只抛个报错码
- 描述里标清视图还是实体表,视图有聚合和过滤逻辑,不标清楚模型会当普通表用
元数据从哪里取
主流关系库都有系统表或信息模式可以查表名、字段、类型和注释,MCP 服务器在启动时读一遍即可,不用手工维护。
-- 以信息模式为例,思路是查表清单和字段清单
SELECT table_name FROM information_schema.tables
WHERE table_schema = 'your_schema' AND table_type = 'BASE TABLE';
SELECT column_name, data_type, is_nullable
FROM information_schema.columns
WHERE table_name = 'your_table';注释字段值得单独取。不少库把业务含义写在字段注释里,信息量比字段名大得多。视图和物化视图要不要暴露按业务决定,暴露了就在返回里标清楚是视图。部分库对系统表权限收紧,读不到注释时退回手工维护的数据字典。
别把整库摊给模型
表结构喂得越全,模型越准,但暴露面也越大。权限要在源头收,别指望提示词里写一句「不要查敏感表」就够。
- 按角色建只读账号,只授权需要的表,从源头缩小模型能看到的范围
- 敏感字段(证件号、手机号)不进元数据描述,或者在查询层做脱敏
- 写操作单独走另一条通道并加人工确认,读和写不要在同一个工具里混
- 留查询日志,出问题能回溯是哪次调用读了哪张表
中转或网关层的稳定性也会影响元数据读取是否稳定,选服务时到 /sites 看当时的检测结果,别只看宣传页。
表名还是对不上时的排查顺序
配完还是查错,别一上来就换模型。按下面顺序走,多数问题在前两步就能定位。
- 看服务器启动日志元数据到底取到没有、取了几张表,日志里应该有。取到零张就是权限或库名配错了。
- 看实际塞进上下文的内容检查系统提示或工具描述里真正进去多少,有没有被长度截断。
- 让模型单独调一次列表工具确认它能看到什么,和日志对得上不。
- 最后才怀疑模型能力多数情况是信息没进去,不是模型不行。
模型对数据库的全部认知,就等于你投喂给它的那几行元数据。下一步把你的库表数量和元数据读取权限先摸清,再决定走全量枚举还是按需查询;接入前的服务可用性和检测结果,到 /sites 核对当时的数据。→
常见问题
MCP 服务器连上数据库,模型就自动知道表结构了吗?
不会。MCP 只是把工具暴露给模型,模型能看到什么取决于服务器在工具描述或返回结果里给了什么。如果服务器没写表结构,模型只能靠猜表名。连接成功不等于信息传到了模型那边。
表特别多,全塞进上下文是不是更好?
不一定。表一多,全量描述会占掉大量上下文,重点反而被稀释,模型更容易挑错表。更稳的做法是先给分组目录或业务域概览,模型需要时再调工具展开某张表的字段。
能不能让模型直接执行 SHOW TABLES 自己看?
可以,但要用受控的方式:把这类查询封装成一个只读工具,限制返回条数并过滤系统表,而不是开放任意 SQL。否则模型可能拼出高风险语句,也容易被大量无关表干扰。
字段名都是缩写,模型总理解错怎么办?
把字段注释和业务含义作为元数据一起传给模型,比只给字段名有效得多。注释缺失时,可以人工维护一份字段对照表,用文档注入的方式按问题召回。
只读账号够不够安全?
只读解决了误删改,但不够。还得限定可见的表范围、对敏感字段脱敏、记录每次查询,并防止通过复杂查询绕过限制。安全是权限、脱敏、审计三件事一起做的结果。