Kiro 配置 MySQL MCP Server 通用教程一、什么是 MCPMCPModel Context Protocol是 Kiro 扩展能力的机制允许 AI 通过 MCP Server 直接访问外部服务如数据库、API等。配置 MySQL MCP Server 后Kiro 可以在对话中直接执行 SQL 查询。二、前置条件1. 安装 uvPython 包管理器uv提供uvx命令用于下载和运行 MCP Server。pipinstalluv安装完成后验证uv--version参考uv 安装指南2. 预装 MCP Server 包推荐为避免运行时下载超时或权限问题建议提前安装uv toolinstallmcp-server-mysql国内网络需指定镜像源uv toolinstallmcp-server-mysql --index-url https://pypi.tuna.tsinghua.edu.cn/simple安装成功后会提示可执行文件路径例如Windows:C:\Users\用户名\.local\bin\mcp-server-mysql.exemacOS/Linux:~/.local/bin/mcp-server-mysql注博客https://blog.csdn.net/badao_liumang_qizhi三、配置文件配置文件路径级别路径作用域工作区级项目/.kiro/settings/mcp.json仅当前项目用户级~/.kiro/settings/mcp.json所有项目共享优先级工作区配置 用户级配置配置文件示例方式一使用 uvx 动态运行简洁需网络{mcpServers:{mysql:{command:uvx,args:[mcp-server-mysql],env:{MYSQL_HOST:localhost,MYSQL_PORT:3306,MYSQL_USER:root,MYSQL_PASSWORD:your_password,MYSQL_DATABASE:your_database},disabled:false,autoApprove:[]}}}方式二使用预装好的可执行文件路径推荐无需网络{mcpServers:{mysql:{command:C:\\Users\\用户名\\.local\\bin\\mcp-server-mysql.exe,args:[],env:{MYSQL_HOST:localhost,MYSQL_PORT:3306,MYSQL_USER:root,MYSQL_PASSWORD:your_password,MYSQL_DATABASE:your_database},disabled:false,autoApprove:[]}}}配置字段说明字段说明commandMCP Server 启动命令可以是uvx或可执行文件的完整路径args命令参数用 uvx 时填包名[mcp-server-mysql]直接路径时填[]env.MYSQL_HOST数据库地址env.MYSQL_PORT数据库端口默认 3306env.MYSQL_USER数据库用户名env.MYSQL_PASSWORD数据库密码env.MYSQL_DATABASE要连接的数据库名disabled是否禁用false为启用autoApprove免确认自动执行的工具名列表空数组表示每次需确认四、连接生效配置文件保存后有两种方式让 Kiro 加载自动检测Kiro 会自动检测配置变更并重连手动重连CtrlShiftP→ 搜索MCP→ 选择重新连接 MCP 服务器连接状态可在 Kiro 功能面板的MCP Server视图中查看。五、使用方式连接成功后直接在对话中让 Kiro 执行 SQL请执行SELECT * FROM users LIMIT 10;Kiro 会调用 MCP 工具执行查询并返回结果。六、常见问题排查问题1‘uvx’ 不是内部或外部命令日志特征uvx 不是内部或外部命令也不是可运行的程序或批处理文件原因uvx.exe所在目录未加入系统 PATH。解决方案二选一方案A将command改为uvx.exe的完整路径方案B将 Python Scripts 目录加入系统 PATH 环境变量查找 uvx 路径python-cimport sysconfig; print(sysconfig.get_path(scripts, nt_user))问题2下载包超时pypi.org 不可访问日志特征Failed to fetch: https://pypi.org/simple/mcp-server-mysql/ Caused by: operation timed out原因国内网络无法访问 PyPI 官方源。解决方案在env中添加国内镜像配置env:{MYSQL_HOST:localhost,MYSQL_PORT:3306,MYSQL_USER:root,MYSQL_PASSWORD:your_password,MYSQL_DATABASE:your_database,UV_INDEX_URL:https://pypi.tuna.tsinghua.edu.cn/simple}或者用方式二预装后直接指定路径彻底绕过运行时下载。问题3pywin32 安装权限拒绝Windows日志特征Failed to install: pywin32-xxx.whl Caused by: 拒绝访问。 (os error -2147024891)原因uvx在临时目录创建可执行文件时被系统权限拦截。解决方案使用管理员权限终端预装uv tool install mcp-server-mysql然后配置中command直接指向安装好的可执行文件路径问题4数据库连接被拒可能原因数据库地址/端口不对用户名密码错误数据库服务器未开放远程连接需要 VPN 才能访问内网数据库排查先在本机用其他工具如 mysql 命令行、Navicat测试能否连接。七、安全建议使用只读账号避免 AI 误执行 DELETE/UPDATE 等危险操作不要提交密码到 Git将.kiro/settings/mcp.json加入.gitignoreautoApprove 谨慎配置留空意味着每次 SQL 执行前需要确认更安全测试环境优先先在测试库验证确认无误再切换生产库八、完整配置流程速查1. pip install uv 2. uv tool install mcp-server-mysql --index-url https://pypi.tuna.tsinghua.edu.cn/simple 3. 创建 .kiro/settings/mcp.json填入数据库连接信息 4. command 使用预装好的可执行文件完整路径 5. CtrlShiftP → MCP → 重新连接 6. MCP Server 视图确认状态为 已连接 7. 在对话中直接让 Kiro 执行 SQL