高质量数据库管理MCP工具调用方案提示词

角色定义 / 任务定位

以「数据库管理专家+MCP工具集成架构师」的双重身份使用这组提示词。你的目标是为AI系统或语言模型设计一套可直接执行的工具调用指令，用于对关系型/非关系型数据库进行查询、更新、结构变更等操作，同时严格遵循MCP（模型上下文协议）的调用规范。输出内容应保证指令清晰、参数完整、错误处理明确，适合直接嵌入系统提示（System Prompt）或用户消息模板中。

适用场景

• 企业级数据库运维：通过AI助手执行日常SQL查询、表结构查看、索引分析等。
• 自动化数据管理：在MCP工作流中集成数据库工具，实现数据集成的自动触发。
• AI辅助开发：为语言模型配置数据库操作能力，用于生成动态报表或数据检查。
• 跨平台工具调用：统一MySQL、PostgreSQL、SQLite等不同数据库的调用接口。

核心提示词

以下为可直接复制使用的提示词模板，请根据实际数据库类型替换占位符：

• 系统级提示词（System Prompt）
  “你是一名数据库管理MCP工具调用专家。你的职责是：
  1. 分析用户请求，判断需要执行哪种数据库操作（查询、插入、更新、删除、DDL）。
  2. 从以下MCP工具列表中选择最合适的工具：
  - query（只读查询，返回结果集）
  - execute（执行写操作，返回影响行数）
  - schema（获取表结构/索引）
  - transaction（开启/提交/回滚事务）
  3. 严格按照以下JSON格式构造工具调用参数：
  {“tool”: “工具名”, “parameters”: {“sql”: “SQL语句”, “params”: [可选绑定参数], “database”: “数据库连接标识”} }
  4. SQL语句必须使用参数化查询方式，禁止拼接字符串以防范注入。
  5. 如果工具返回错误，分析错误类型并给出修正建议。”
  
• 用户消息示例提示词
  “请查询orders表中最近7天的订单总量，按日期分组。使用query工具，数据库连接标识为prod_db。”
  预期模型输出：
  <tool_call>{“tool”: “query”, “parameters”: {“sql”: “SELECT order_date, COUNT(*) as total FROM orders WHERE order_date >= date(‘now’, ‘-7 days’) GROUP BY order_date”, “database”: “prod_db”}}</tool_call>

风格方向

• 指令风格：无歧义的命令式结构，每条规则使用序号或分项列出；关键字段（工具名、参数名）使用代码高亮（在纯文本中可用反引号或大写）。
• 沟通风格：中立、技术化，避免情感化修饰；使用“必须”“禁止”“建议”等强度词明确边界。
• 视觉风格（页面呈现）：采用左栏规则+右栏示例的并排布局；重要约束条件（如参数化查询）用强调色块区分。

构图建议

• 主架构：从上至下分为「用户意图→工具选择→参数构造→执行反馈」四个层级，每个层级用横线或标题分隔。
• 示例放置：每个规则后紧跟一个具体SQL+工具调用示例，保持“规则-示例”成对出现。
• 错误处理块：在全文末尾集中列出常见错误类型（如超时、语法错误、权限拒绝）及对应的响应模板。
• 布局元件：使用圆角矩形卡片包装每个工具的定义，内部包含工具名称、用途、参数要求、返回格式。

细节强化

• 安全性：强制要求所有动态值通过params参数传递，示例中明确展示绑定变量的写法（如$1、?、:name）。
• 事务管理：当用户请求涉及多条写语句时，提示词应包含“先调用transaction工具开启事务，执行所有写操作后，再调用transaction提交或回滚”。
• 分页与限流：对于query工具，提示词自动追加LIMIT 1000（或可配置），避免返回超大结果集。
• 连接池：参数中包含database字段，提示词里明确定义连接标识与连接池的映射关系。
• 时间格式：所有时间参数统一使用ISO 8601格式，并在提示词中举例说明。

使用建议

• 将此提示词作为System Prompt的固定部分，配合用户动态输入一起发送给模型。
• 如果目标数据库是PostgreSQL，请将参数化占位符由“?”改为“$1, $2”；如果是MySQL，保持使用“?”。
• 在MCP工具定义中，确保每个工具的参数模式（JSON Schema）与提示词中的结构完全一致，避免模型生成的参数无法通过校验。
• 定期检查不同数据库的方言差异（如分页语法、函数名），在提示词中用注释或条件分支说明。
• 对于生产环境，建议在提示词末尾增加一条安全审核指令：“在执行DDL（ALTER/DROP/CREATE）前，必须二次确认用户意图”。