1. 从一句“帮我查下上个月订单”说起智能问数这件事听起来像是数据团队的专属能力但实际做起来门槛比想象中低很多。你手上只要有一个能连的数据库再加上 Coze 的智能体编排能力配合开源的 universal-db-mcp 这个数据库万能连接器就能搭出一个能听懂人话、自己生成 SQL、把结果整理成表格返回的 AskDB 问数智能体。它适合谁适合不想写复杂后端、又想给项目或自己加一个“对话式查库”入口的开发者也适合刚接触智能体、想找一个完整可跟做案例练手的小白。universal-db-mcp 的核心价值在于把数据库连接和查询能力封装成了标准接口支持 MCP 模式和 HTTP API 模式。MCP 模式可以直接挂到 Claude Desktop、Cherry Studio 这类客户端上HTTP API 模式则更适合接入 Coze 这种平台通过插件的方式把 health_check、connect_database、execute_query、list_tables、get_table_schema 这几个工具暴露给智能体调用。整条链路跑通之后你在 Coze 里跟智能体说“连接数据库”它会一步步问你要类型、主机、端口、账号密码和库名连上之后返回一个 sessionId后续所有查询都靠这个会话 ID 维持上下文。这篇文章会从零开始把 Coze 里创建插件、填参数、写提示词、调试对话的完整路径走一遍。中间会给出可复制的配置骨架和验证对话示例也会把容易踩的坑提前标出来。你不需要有 Coze 深度使用经验跟着步骤操作就能跑通从建库到提问的第一条链路。2. 前置准备把 universal-db-mcp 跑起来在 Coze 里建插件之前你得先有一个能访问的 universal-db-mcp 服务地址。这个服务可以部署在自己的服务器上也可以放在 Serverless 平台或者 PaaS 平台上。如果条件允许优先选自有服务器原因是不会有冷启动长连接也更稳定问数场景下会话保持会更顺滑。部署方式在 universal-db-mcp 的 GitHub 仓库里有详细说明这里不展开重复。你只需要确认两件事第一服务启动后健康检查接口能正常返回第二你拿到了服务的基础 URL比如https://your-domain.com或者http://your-ip:port。后面在 Coze 插件里填的接口地址就是基于这个基础 URL 拼出来的。如果你打算把这个能力暴露给项目用还需要考虑鉴权。universal-db-mcp 的 HTTP API 模式支持通过请求头传递认证信息具体字段名以仓库文档为准。在 Coze 插件里配置时可以把这部分放到 Header 里避免把敏感信息写死在提示词中。另外提醒一点数据库账号建议单独开一个只读账号只授予 SELECT 权限。虽然提示词里会限制只执行查询但多一层数据库层面的权限控制心里会更踏实。3. 在 Coze 中创建智能体与插件进入 Coze 平台的扣子编程界面选择智能体开发新建一个智能体。名称可以叫“问数 AskDB”描述写“连接数据库并用自然语言查询数据”。创建完成后进入智能体的编排页面。接下来创建 API 插件。在插件管理里新建一个插件名称填universal-db-mcp描述写“数据库万能连接器支持连接 MySQL、PostgreSQL、SQLite 并执行查询”。插件的核心是配置工具也就是把 universal-db-mcp 暴露的 HTTP 接口映射成 Coze 能调用的工具。这里有一个关键点Coze 插件的每个工具都需要独立的接口地址和参数定义。universal-db-mcp 的 HTTP API 模式通常会把不同功能放在不同路径下比如/health、/connect、/query、/tables、/schema。你需要根据仓库文档确认实际路径然后在 Coze 里逐个创建。创建工具时请求方法、路径、参数位置都要填对。参数位置一般选 BodyContent-Type 选application/json。如果接口需要认证在 Header 里加上对应的字段。每个工具创建完后Coze 会要求你填写输出参数可以先用示例响应让平台自动解析也可以手动定义。五个工具都创建完之后回到智能体编排页面把这个插件添加到智能体上。添加时注意勾选全部工具这样智能体在对话中才能按需调用。4. 可复制的插件工具配置骨架下面给出五个工具的参数配置骨架你可以直接对照着填。实际字段名以 universal-db-mcp 仓库文档为准这里展示的是结构和思路。4.1 health_check 工具这个工具用来检查服务是否存活参数为空请求方法 GET路径/health。输出一般包含status字段。它的作用是在连接数据库之前先确认服务可用避免后面报错时搞不清是服务挂了还是数据库连不上。4.2 connect_database 工具请求方法 POST路径/connectBody 参数如下参数名类型必填说明db_typestring是mysql、postgres、sqlitehoststring是数据库主机地址portinteger是端口号MySQL 默认 3306userstring是用户名passwordstring是密码databasestring是数据库名输出里会返回一个sessionId这个值必须保存下来后续所有查询都要带上它。在提示词里要明确告诉智能体连接成功后记住 sessionId。4.3 execute_query 工具请求方法 POST路径/queryBody 参数参数名类型必填说明session_idstring是连接时返回的会话 IDsqlstring是要执行的 SQL 语句输出是查询结果集通常是数组或对象。提示词里要限制只生成 SELECT 语句并且默认加 LIMIT 100。4.4 list_tables 工具请求方法 POST路径/tablesBody 参数只有session_id。返回当前数据库的所有表名。智能体在生成 SQL 之前应该先调用这个工具了解有哪些表可用。4.5 get_table_schema 工具请求方法 POST路径/schemaBody 参数参数名类型必填说明session_idstring是会话 IDtable_namestring是表名返回该表的字段名、类型、注释等信息。智能体拿到 schema 之后生成 SQL 的准确率会明显提升。注意如果 universal-db-mcp 的接口路径或参数名与上面不一致以仓库文档为准。配置的核心逻辑是“一个功能对应一个工具”不要试图把所有功能塞进一个接口。5. 提示词与模型设置插件配好之后智能体能不能用好这些工具取决于提示词。下面这份提示词可以直接复制也可以按自己的场景调整。# 角色 你是一个专业的数据库查询助手能够帮助用户连接数据库并使用自然语言查询数据。 # 技能 ## 技能1连接数据库 当用户要求连接数据库时 1. 询问用户数据库类型mysql、postgres、sqlite 2. 询问数据库连接信息主机、端口、用户名、密码、数据库名 3. 调用 connect_database 接口连接数据库 4. 保存返回的 sessionId 用于后续查询 5. 告知用户连接结果 ## 技能2查询数据 当用户询问数据相关问题时 1. 如果还未连接数据库提示用户先连接 2. 先调用 list_tables 查看有哪些表 3. 调用 get_table_schema 了解相关表的结构 4. 根据用户的自然语言问题生成合适的 SQL 查询语句 5. 调用 execute_query 执行查询 6. 将查询结果以易读的方式呈现给用户使用表格或列表 ## 技能3数据分析 当用户需要数据分析时 1. 理解用户的分析需求 2. 生成适当的聚合查询COUNT、SUM、AVG、GROUP BY等 3. 执行查询并解读结果 4. 提供简洁的分析结论 # 限制 - 只执行 SELECT 查询不执行 INSERT、UPDATE、DELETE 等写操作 - 查询结果默认限制 100 条避免返回过多数据 - 如果用户的问题不清晰主动询问澄清 - 保护用户隐私不在对话中暴露敏感信息 # 示例对话 用户连接我的MySQL数据库 助手好的请提供以下数据库连接信息 1. 主机地址如localhost 或 IP地址 2. 端口MySQL默认3306 3. 用户名 4. 密码 5. 数据库名称 用户查看所有用户 助手[调用 list_tables 和 get_table_schema] [生成 SQL: SELECT * FROM users LIMIT 100] [调用 execute_query] 查询到 10 条用户记录 | ID | 姓名 | 邮箱 | |-----|------|------| | 1 | 张三 | zhangsanexample.com | | 2 | 李四 | lisiexample.com | 用户上个月有多少订单 助手[分析问题生成 SQL] [执行查询] 上个月共有 1,234 个订单。模型选择上建议开启深度思考开关。问数场景涉及自然语言到 SQL 的转换模型需要一定的推理能力开启后生成 SQL 的准确率会更高。如果 Coze 平台上有多个模型可选优先选推理能力强的版本。6. 验证请求与成功结果配置完成后在 Coze 的调试窗口里测试。第一轮先发“连接数据库”智能体应该会回复一段询问连接信息的消息。你把数据库信息按格式发过去比如DB_TYPEmysql DB_HOST127.0.0.1 DB_PORT3306 DB_USERreadonly_user DB_PASSWORDyour_password DB_DATABASEtest_db如果一切正常智能体会调用 connect_database 工具然后返回类似下面的结果数据库连接成功以下是连接信息摘要 数据库类型: MySQL 主机地址: 127.0.0.1 端口: 3306 数据库名称: test_db 会话 ID: xxxxxxxxxxxxx 现在可以开始进行数据查询了。拿到 sessionId 之后继续发“列出所有表”智能体会调用 list_tables返回表名列表。接着发“查看 users 表的结构”它会调用 get_table_schema。最后发“统计 users 表有多少条记录”它会生成SELECT COUNT(*) FROM users并调用 execute_query返回统计结果。整个过程中你可以在 Coze 的调试面板里看到每次工具调用的入参和出参。如果某个环节没有触发工具调用说明提示词里的触发条件不够明确可以回去调整。7. 本篇常见错排查7.1 连接数据库时报“服务不可达”先单独用 curl 测一下 universal-db-mcp 的 health_check 接口curl -X GET https://your-domain.com/health如果返回非 200说明服务本身有问题跟 Coze 无关。检查服务是否启动、端口是否开放、反向代理是否配置正确。7.2 连接成功但查询时报“session 无效”大概率是 sessionId 没有在对话中正确传递。检查提示词里是否明确要求“保存返回的 sessionId 用于后续查询”以及 execute_query 工具的 session_id 参数是否映射到了正确的字段。有些平台的参数名是下划线风格有些是驼峰风格填错会导致传空值。7.3 智能体不调用工具直接编造答案这是提示词约束不够导致的。在限制里加上“必须调用工具获取真实数据禁止编造查询结果”。同时检查插件是否已经正确添加到智能体上工具是否全部勾选。7.4 SQL 生成错误或字段名不对先确认 get_table_schema 是否被调用。如果智能体跳过了 schema 查询直接写 SQL字段名很容易猜错。在提示词里把“先调用 list_tables再调用 get_table_schema”写成强制步骤。7.5 查询结果太长导致回复截断在提示词里限制默认 LIMIT 100并且在 execute_query 的输出处理上做截断。如果确实需要看全量数据可以让用户明确说“不要限制条数”但这种情况要谨慎避免把数据库拖垮。7.6 Coze 插件调试报参数类型错误检查 Body 参数的 JSON Schema 定义。整数类型的 port 不要写成 string布尔类型的参数不要写成 string。Coze 在调用时会按定义做类型校验类型不匹配会直接报错。8. 把问数能力接到项目里智能体在 Coze 里跑通之后你可以通过 Coze 的 API 接口把它暴露给外部项目调用。这样你的业务系统里就能加一个“对话查数”的入口用户输入自然语言后端转发给 Coze 智能体拿到结果再返回给前端。如果你后续想把这个问数智能体用在更长期的编码或 Agent 场景里可以关注一下 Coding Plan 相关的接入方式。对于需要频繁调试模型对话、验证 SQL 生成效果的场景可以直接在模型对话页面里试。而插件和 API Key 的管理在控制台和 API Keys 页面里操作会更顺手。接入文档里对 HTTP API 的调用方式有完整说明包括请求头、请求体格式和返回结构。你可以先用 curl 跑通一次调用再集成到自己的代码里。整个链路的稳定性很大程度上取决于 universal-db-mcp 服务的部署质量和数据库只读账号的权限控制这两点值得多花点时间。
1. 从一句“帮我查下上个月订单”说起智能问数这件事听起来像是数据团队的专属能力但实际做起来门槛比想象中低很多。你手上只要有一个能连的数据库再加上 Coze 的智能体编排能力配合开源的 universal-db-mcp 这个数据库万能连接器就能搭出一个能听懂人话、自己生成 SQL、把结果整理成表格返回的 AskDB 问数智能体。它适合谁适合不想写复杂后端、又想给项目或自己加一个“对话式查库”入口的开发者也适合刚接触智能体、想找一个完整可跟做案例练手的小白。universal-db-mcp 的核心价值在于把数据库连接和查询能力封装成了标准接口支持 MCP 模式和 HTTP API 模式。MCP 模式可以直接挂到 Claude Desktop、Cherry Studio 这类客户端上HTTP API 模式则更适合接入 Coze 这种平台通过插件的方式把 health_check、connect_database、execute_query、list_tables、get_table_schema 这几个工具暴露给智能体调用。整条链路跑通之后你在 Coze 里跟智能体说“连接数据库”它会一步步问你要类型、主机、端口、账号密码和库名连上之后返回一个 sessionId后续所有查询都靠这个会话 ID 维持上下文。这篇文章会从零开始把 Coze 里创建插件、填参数、写提示词、调试对话的完整路径走一遍。中间会给出可复制的配置骨架和验证对话示例也会把容易踩的坑提前标出来。你不需要有 Coze 深度使用经验跟着步骤操作就能跑通从建库到提问的第一条链路。2. 前置准备把 universal-db-mcp 跑起来在 Coze 里建插件之前你得先有一个能访问的 universal-db-mcp 服务地址。这个服务可以部署在自己的服务器上也可以放在 Serverless 平台或者 PaaS 平台上。如果条件允许优先选自有服务器原因是不会有冷启动长连接也更稳定问数场景下会话保持会更顺滑。部署方式在 universal-db-mcp 的 GitHub 仓库里有详细说明这里不展开重复。你只需要确认两件事第一服务启动后健康检查接口能正常返回第二你拿到了服务的基础 URL比如https://your-domain.com或者http://your-ip:port。后面在 Coze 插件里填的接口地址就是基于这个基础 URL 拼出来的。如果你打算把这个能力暴露给项目用还需要考虑鉴权。universal-db-mcp 的 HTTP API 模式支持通过请求头传递认证信息具体字段名以仓库文档为准。在 Coze 插件里配置时可以把这部分放到 Header 里避免把敏感信息写死在提示词中。另外提醒一点数据库账号建议单独开一个只读账号只授予 SELECT 权限。虽然提示词里会限制只执行查询但多一层数据库层面的权限控制心里会更踏实。3. 在 Coze 中创建智能体与插件进入 Coze 平台的扣子编程界面选择智能体开发新建一个智能体。名称可以叫“问数 AskDB”描述写“连接数据库并用自然语言查询数据”。创建完成后进入智能体的编排页面。接下来创建 API 插件。在插件管理里新建一个插件名称填universal-db-mcp描述写“数据库万能连接器支持连接 MySQL、PostgreSQL、SQLite 并执行查询”。插件的核心是配置工具也就是把 universal-db-mcp 暴露的 HTTP 接口映射成 Coze 能调用的工具。这里有一个关键点Coze 插件的每个工具都需要独立的接口地址和参数定义。universal-db-mcp 的 HTTP API 模式通常会把不同功能放在不同路径下比如/health、/connect、/query、/tables、/schema。你需要根据仓库文档确认实际路径然后在 Coze 里逐个创建。创建工具时请求方法、路径、参数位置都要填对。参数位置一般选 BodyContent-Type 选application/json。如果接口需要认证在 Header 里加上对应的字段。每个工具创建完后Coze 会要求你填写输出参数可以先用示例响应让平台自动解析也可以手动定义。五个工具都创建完之后回到智能体编排页面把这个插件添加到智能体上。添加时注意勾选全部工具这样智能体在对话中才能按需调用。4. 可复制的插件工具配置骨架下面给出五个工具的参数配置骨架你可以直接对照着填。实际字段名以 universal-db-mcp 仓库文档为准这里展示的是结构和思路。4.1 health_check 工具这个工具用来检查服务是否存活参数为空请求方法 GET路径/health。输出一般包含status字段。它的作用是在连接数据库之前先确认服务可用避免后面报错时搞不清是服务挂了还是数据库连不上。4.2 connect_database 工具请求方法 POST路径/connectBody 参数如下参数名类型必填说明db_typestring是mysql、postgres、sqlitehoststring是数据库主机地址portinteger是端口号MySQL 默认 3306userstring是用户名passwordstring是密码databasestring是数据库名输出里会返回一个sessionId这个值必须保存下来后续所有查询都要带上它。在提示词里要明确告诉智能体连接成功后记住 sessionId。4.3 execute_query 工具请求方法 POST路径/queryBody 参数参数名类型必填说明session_idstring是连接时返回的会话 IDsqlstring是要执行的 SQL 语句输出是查询结果集通常是数组或对象。提示词里要限制只生成 SELECT 语句并且默认加 LIMIT 100。4.4 list_tables 工具请求方法 POST路径/tablesBody 参数只有session_id。返回当前数据库的所有表名。智能体在生成 SQL 之前应该先调用这个工具了解有哪些表可用。4.5 get_table_schema 工具请求方法 POST路径/schemaBody 参数参数名类型必填说明session_idstring是会话 IDtable_namestring是表名返回该表的字段名、类型、注释等信息。智能体拿到 schema 之后生成 SQL 的准确率会明显提升。注意如果 universal-db-mcp 的接口路径或参数名与上面不一致以仓库文档为准。配置的核心逻辑是“一个功能对应一个工具”不要试图把所有功能塞进一个接口。5. 提示词与模型设置插件配好之后智能体能不能用好这些工具取决于提示词。下面这份提示词可以直接复制也可以按自己的场景调整。# 角色 你是一个专业的数据库查询助手能够帮助用户连接数据库并使用自然语言查询数据。 # 技能 ## 技能1连接数据库 当用户要求连接数据库时 1. 询问用户数据库类型mysql、postgres、sqlite 2. 询问数据库连接信息主机、端口、用户名、密码、数据库名 3. 调用 connect_database 接口连接数据库 4. 保存返回的 sessionId 用于后续查询 5. 告知用户连接结果 ## 技能2查询数据 当用户询问数据相关问题时 1. 如果还未连接数据库提示用户先连接 2. 先调用 list_tables 查看有哪些表 3. 调用 get_table_schema 了解相关表的结构 4. 根据用户的自然语言问题生成合适的 SQL 查询语句 5. 调用 execute_query 执行查询 6. 将查询结果以易读的方式呈现给用户使用表格或列表 ## 技能3数据分析 当用户需要数据分析时 1. 理解用户的分析需求 2. 生成适当的聚合查询COUNT、SUM、AVG、GROUP BY等 3. 执行查询并解读结果 4. 提供简洁的分析结论 # 限制 - 只执行 SELECT 查询不执行 INSERT、UPDATE、DELETE 等写操作 - 查询结果默认限制 100 条避免返回过多数据 - 如果用户的问题不清晰主动询问澄清 - 保护用户隐私不在对话中暴露敏感信息 # 示例对话 用户连接我的MySQL数据库 助手好的请提供以下数据库连接信息 1. 主机地址如localhost 或 IP地址 2. 端口MySQL默认3306 3. 用户名 4. 密码 5. 数据库名称 用户查看所有用户 助手[调用 list_tables 和 get_table_schema] [生成 SQL: SELECT * FROM users LIMIT 100] [调用 execute_query] 查询到 10 条用户记录 | ID | 姓名 | 邮箱 | |-----|------|------| | 1 | 张三 | zhangsanexample.com | | 2 | 李四 | lisiexample.com | 用户上个月有多少订单 助手[分析问题生成 SQL] [执行查询] 上个月共有 1,234 个订单。模型选择上建议开启深度思考开关。问数场景涉及自然语言到 SQL 的转换模型需要一定的推理能力开启后生成 SQL 的准确率会更高。如果 Coze 平台上有多个模型可选优先选推理能力强的版本。6. 验证请求与成功结果配置完成后在 Coze 的调试窗口里测试。第一轮先发“连接数据库”智能体应该会回复一段询问连接信息的消息。你把数据库信息按格式发过去比如DB_TYPEmysql DB_HOST127.0.0.1 DB_PORT3306 DB_USERreadonly_user DB_PASSWORDyour_password DB_DATABASEtest_db如果一切正常智能体会调用 connect_database 工具然后返回类似下面的结果数据库连接成功以下是连接信息摘要 数据库类型: MySQL 主机地址: 127.0.0.1 端口: 3306 数据库名称: test_db 会话 ID: xxxxxxxxxxxxx 现在可以开始进行数据查询了。拿到 sessionId 之后继续发“列出所有表”智能体会调用 list_tables返回表名列表。接着发“查看 users 表的结构”它会调用 get_table_schema。最后发“统计 users 表有多少条记录”它会生成SELECT COUNT(*) FROM users并调用 execute_query返回统计结果。整个过程中你可以在 Coze 的调试面板里看到每次工具调用的入参和出参。如果某个环节没有触发工具调用说明提示词里的触发条件不够明确可以回去调整。7. 本篇常见错排查7.1 连接数据库时报“服务不可达”先单独用 curl 测一下 universal-db-mcp 的 health_check 接口curl -X GET https://your-domain.com/health如果返回非 200说明服务本身有问题跟 Coze 无关。检查服务是否启动、端口是否开放、反向代理是否配置正确。7.2 连接成功但查询时报“session 无效”大概率是 sessionId 没有在对话中正确传递。检查提示词里是否明确要求“保存返回的 sessionId 用于后续查询”以及 execute_query 工具的 session_id 参数是否映射到了正确的字段。有些平台的参数名是下划线风格有些是驼峰风格填错会导致传空值。7.3 智能体不调用工具直接编造答案这是提示词约束不够导致的。在限制里加上“必须调用工具获取真实数据禁止编造查询结果”。同时检查插件是否已经正确添加到智能体上工具是否全部勾选。7.4 SQL 生成错误或字段名不对先确认 get_table_schema 是否被调用。如果智能体跳过了 schema 查询直接写 SQL字段名很容易猜错。在提示词里把“先调用 list_tables再调用 get_table_schema”写成强制步骤。7.5 查询结果太长导致回复截断在提示词里限制默认 LIMIT 100并且在 execute_query 的输出处理上做截断。如果确实需要看全量数据可以让用户明确说“不要限制条数”但这种情况要谨慎避免把数据库拖垮。7.6 Coze 插件调试报参数类型错误检查 Body 参数的 JSON Schema 定义。整数类型的 port 不要写成 string布尔类型的参数不要写成 string。Coze 在调用时会按定义做类型校验类型不匹配会直接报错。8. 把问数能力接到项目里智能体在 Coze 里跑通之后你可以通过 Coze 的 API 接口把它暴露给外部项目调用。这样你的业务系统里就能加一个“对话查数”的入口用户输入自然语言后端转发给 Coze 智能体拿到结果再返回给前端。如果你后续想把这个问数智能体用在更长期的编码或 Agent 场景里可以关注一下 Coding Plan 相关的接入方式。对于需要频繁调试模型对话、验证 SQL 生成效果的场景可以直接在模型对话页面里试。而插件和 API Key 的管理在控制台和 API Keys 页面里操作会更顺手。接入文档里对 HTTP API 的调用方式有完整说明包括请求头、请求体格式和返回结构。你可以先用 curl 跑通一次调用再集成到自己的代码里。整个链路的稳定性很大程度上取决于 universal-db-mcp 服务的部署质量和数据库只读账号的权限控制这两点值得多花点时间。
