AI 能说不能做，而 MCP 就像 AI 世界的 USB-C，把模型和外部工具统一连接起来，安装并配置 MySQL MCP Server，就能让让 Claude Code 能直接动手操作数据库，而不是让你来回复制粘贴。

适合谁读：已完成 Claude Code CLI 安装，希望在终端里用自然语言查表、跑 SQL、导出数据的开发者。
读完能收获：理解 MCP Server 的安装逻辑，完成 MySQL 连接配置，并能在 Claude Code 中完成结构探索、查询、插入与导出等常见数据库操作。

快速参考

学习目标

通过本节实操，你将学会：

• 理解 MCP Server 的安装原理
• 完成 MySQL MCP Server 的配置
• 在 Claude Code 中用自然语言操作数据库
• 体会 MCP 带来的效率提升

一、理解 MCP Server 的安装逻辑

MCP Server 本质上是一个独立运行的程序，它通过标准输入输出（stdio）与 Claude Code 通信。安装一个 MCP Server 只需要做两件事：

1. 告诉 Claude Code 怎么启动这个程序——在配置里写好 command 和 args
2. 告诉这个程序怎么连接外部资源——在配置里写好环境变量 env（例如 MySQL 的主机、端口、账号、密码、库名）

Claude Code 负责拉起 MCP Server；MCP Server 负责连上 MySQL 并暴露工具（如列库表、执行 SQL、插入、导出等）。你不需要单独「部署一个 Web 服务」，配置正确、环境就绪即可。

二、环境准备

在安装 MySQL MCP Server 之前，请确认以下环境已就绪：

请逐项检查。若某项未就绪，请先回顾安装教程或启动本地 MySQL 服务，再进入下一节。

三、安装与配置 MySQL MCP Server

本节使用社区包 @pickstar-2002/mysql-mcp，它提供约 15 个数据库操作工具（列库表、描述表结构、查询、插入、导出等）。

3.1 方式一：命令行添加（推荐，最快捷）

在终端执行（将环境变量换成你的实际值）：

参数说明：

指定作用域：

• 项目作用域（默认）：配置写入项目下的 .mcp.json，仅当前项目生效
• 用户作用域：在命令中加 -s user，配置写入用户目录，对所有项目生效

注意： 使用 project 作用域时，密码会写入 .mcp.json。请确保 .gitignore 中包含 .mcp.json，避免密码进入版本库。

3.2 方式二：编辑配置文件（推荐与教程对照）

在项目根目录创建 .mcp.json，或在全局 ~/.claude/settings.json 的 mcpServers 字段中添加同名配置（对所有项目生效）。

将 your_password、your_database 替换为实际的 MySQL 密码和数据库名：

3.3 方式三：npm 安装

若希望减少每次 npx 下载的等待，可先全局或项目内安装 @pickstar-2002/mysql-mcp，再把配置中的 command / args 改为指向本地已安装的入口（具体路径以 npm list -g 或项目 node_modules/.bin 为准）。适合网络不稳定、需要固定版本的场景。

3.4 方式四：让 CLI 自己安装

也可以在 Claude Code 里用自然语言描述需求，例如：「帮我添加一个连接本地 MySQL 的 MCP，库名是 xxx」。CLI 会引导你补全参数并写入配置，适合第一次接触 MCP 时快速上手；熟练后仍建议用方式一或方式二，便于复现和团队共享（注意勿把含密码的配置提交到 Git）。

四、验证 MCP 连接

配置完成后，必须重启 Claude Code 才能加载新的 MCP Server。

1. 重新进入项目目录并启动 claude
2. 输入 /mcp，查看 mysql-mcp 是否已列出且状态正常（非红色/错误）
3. 用自然语言测试，例如：「列出当前数据库里所有表」或「测试一下数据库连接是否正常」

若 /mcp 中服务器报错，可在本机终端用与配置相同的 env 手动执行一次 npx -y @pickstar-2002/mysql-mcp@latest，根据终端报错排查环境变量或 MySQL 是否可达。

五、实战：用自然语言操作数据库

以员工管理系统为例，体会 MCP 前后工作流的差异。

操作 1：探索数据库结构

对 AI 说：「列出数据库里所有表，并说明 employee 表的结构。」

AI 会自动调用 mysql_list_tables、mysql_describe_table 等工具并返回结果，无需你打开 Navicat、DBeaver 或命令行客户端。

操作 2：查询数据

对 AI 说：「查询各部门在职员工数量，并简要分析。」

AI 会生成并执行 SQL，直接返回结果与分析，你甚至不必手写 SQL。

操作 3：插入数据

对 AI 说：「在员工表插入一条测试数据，部门为技术部。」

AI 会调用 mysql_insert 等工具完成插入并反馈执行结果。

操作 4：导出数据

对 AI 说：「把刚才的查询结果导出成文件。」

AI 会调用 mysql_export_data，将结果导出到本地文件。

效果对比

以「查询各部门在职员工数量」为例：

MCP 的价值不是「让 AI 更聪明」，而是让 AI 能直接动手——省去你和工具之间的人工中转。

六、安全注意事项

MCP 让 AI 能直接操作数据库，权限越大风险越高，建议默认按「最小权限」配置。

6.1 使用最小权限账号

不要用 root 连接生产或日常开发库。为 MCP 单独建账号，只授予必要库的 SELECT / INSERT / UPDATE（若仅需查询，只给 SELECT）。生产环境优先只读账号，避免误删改。

6.2 保护密码安全

• 不要将 .mcp.json 提交到 Git——在 .gitignore 中加入 .mcp.json
• 优先使用 user 作用域：claude mcp add ... -s user，把含密码的配置放在用户目录而非项目仓库
• 团队共享时只提交脱敏模板（占位符密码），每人本地填真实值

6.3 网络安全

• 配置中优先使用 localhost，避免把 MySQL 暴露到公网
• 远程库请用 SSH 隧道，不要直接对公网开放 3306

七、常见问题排查

问题 1：/mcp看不到 mysql-mcp 或工具不可用

1. 确认 JSON 格式正确（逗号、引号、括号匹配）
2. 确认已重启 Claude Code
3. 在 Claude Code 中运行 /mcp 查看服务器状态；若为红色，按第四节在本机终端单独启动 MCP 排查 env 与数据库连通性

问题 2：npx首次运行很慢

首次运行需下载包，可能需 10～30 秒。网络不佳时可先全局安装 @pickstar-2002/mysql-mcp，再把配置中的启动方式改为本地已安装命令，避免每次拉包。

问题 3：连接数据库失败

问题 4：如何移除 MCP 配置

• 命令行：claude mcp remove mysql-mcp（名称与添加时一致）
• 或手动编辑 .mcp.json / settings.json，删除对应 mcpServers 条目后重启 Claude Code

八、本章小结

三节回顾

从 Skill 到 MCP：能力递进

• Skill 解决的是代码风格和流程规范——让 AI 生成的代码符合团队标准
• MCP 解决的是能力边界——让 AI 能访问数据库、调用 API、操作外部系统

两者结合，AI 更接近「既懂规范、又能动手」的协作成员：Skill 管「怎么写」，MCP 管「能碰到什么」。