> 技术文档 > 在Trae中配置MySQL-MCP服务器的完整指南_trae mysql mcp

在Trae中配置MySQL-MCP服务器的完整指南_trae mysql mcp

**背景介绍 **
模型上下文协议(MCP)是连接AI模型与外部服务的桥梁,MySQL-MCP服务器则是实现AI与数据库交互的核心组件。通过Trae的MCP服务,开发者可以构建智能体来自动执行数据库查询、数据分析等操作。本文将以最新版Trae(2025年5月)为基础,详解配置流程。


环境准备

  1. 基础依赖
    • Python 3.8+(MySQL-MCP服务基于Python开发)

• Node.js ≥18(Trae的核心依赖)

• MySQL 5.7+/8.0+(确保已创建目标数据库)

  1. 工具链安装
# 安装Python包管理器(若未安装)curl -sSL https://astral.sh/uv/install.sh | sh# 安装MySQL-MCP服务器核心组件pip install mysql-mcp-server

配置步骤详解

步骤1:服务端部署
通过终端安装核心服务:

# 使用官方推荐方式安装(自动处理依赖)npx -y @smithery/cli install mysql-mcp-server --client trae

注:此命令会自动配置Python虚拟环境并下载依赖库


步骤2:Trae的MCP配置
在Trae界面中按以下流程操作:

  1. 打开MCP设置:右上角设置图标 → MCP → 手动配置
  2. 粘贴JSON配置:
{ \"mcpServers\": { \"mysql\": { \"command\": \"mysql_mcp_serve\", \"args\": [], \"env\": { \"MYSQL_HOST\": \"127.0.0.1\", \"MYSQL_PORT\": \"3306\", \"MYSQL_USER\": \"root\", \"MYSQL_PASSWORD\": \"你的密码\", \"MYSQL_DATABASE\": \"目标数据库名\" } } }}

重要说明:
• 若使用Docker版MySQL,需将127.0.0.1改为host.docker.internal


步骤3:权限验证
在终端执行测试命令:

 mysql_mcp_server list-tables

若返回访问权限失败,则说明创建成功。


高级功能实现
场景1:自然语言转SQL查询
通过集成Xiyan-MCP服务(需额外安装):

# 安装自然语言处理扩展pip install xiyan-mcp-server# 配置双服务联动{ \"mcpServers\": { \"mysql\": {...}, // 前述配置 \"xiyan\": { \"command\": \"uvx\", \"args\": [\"--from\", \"xiyan-mcp-server\"], \"env\": {\"MODEL_API_KEY\": \"sk-xxxx\"} } }}

此时可向智能体发送:“统计过去一周订单量最高的前5个商品”


场景2:自动化报表生成
结合QuickChart-MCP服务实现数据可视化:

{ \"mcpServers\": { \"mysql\": {...}, \"quickchart\": { \"command\": \"npx\", \"args\": [\"@gongrzhe/quickchart-mcp-server\"] } }}

智能体可自动执行SQL查询→生成柱状图→输出HTML报告