MCP 安装与使用：在 Claude Code 中用自然语言操作 MySQL

MY_TEUCK2026-05-26 8:54

理解 MCP Server 的安装原理，完成 MySQL MCP Server 配置，并在 Claude Code 中用自然语言查询、写入与导出数据库数据。

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

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

快速参考

项目 说明
MCP Server 包 @pickstar-2002/mysql-mcp（社区维护，约 15 个数据库工具）
运行环境 Node.js ≥ 18 ，Claude Code 最新版
目标数据库 MySQL 5.7+ （推荐 8.0+）
项目级配置 项目根目录 .mcp.json
全局配置 ~/.claude/settings.json（Windows：%USERPROFILE%\.claude\settings.json）
配置生效 修改后必须重启 Claude Code
验证命令 在 Claude Code 中输入 /mcp 查看服务器状态

学习目标

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

  • 理解 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 之前，请确认以下环境已就绪：

依赖 最低版本 验证方式 说明
Node.js ≥ 18 node -v MCP Server 的运行环境
Claude Code 最新版 claude --version 见 Claude Code 安装教程
MySQL 5.7+（推荐 8.0+） mysql --version 要连接的目标数据库

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

三、安装与配置 MySQL MCP Server

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

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

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

复制代码 
claude mcp add mysql-mcp \
  -e MYSQL_HOST=localhost \
  -e MYSQL_PORT=3306 \
  -e MYSQL_USER=root \
  -e MYSQL_PASSWORD=123456 \
  -- npx @pickstar-2002/mysql-mcp@latest

参数说明：

参数 说明
mysql-mcp MCP 服务器名称，可自定义
-e KEY=VALUE 环境变量，每个数据库连接参数一个
-- 分隔符，后面是启动 MCP Server 的命令
npx @pickstar-2002/mysql-mcp@latest 启动命令；npx 会自动下载并运行

指定作用域：

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

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

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

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

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

json 复制代码 
{
  "mcpServers": {
    "mysql-mcp": {
      "command": "npx",
      "args": ["-y", "@pickstar-2002/mysql-mcp@latest"],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "root",
        "MYSQL_PASSWORD": "your_password",
        "MYSQL_DATABASE": "your_database"
      }
    }
  }
}

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 或命令行客户端。

没有 MCP 有 MCP
打开客户端 → 输入密码 → 点库看表 → 点表看结构 → 截图或复制给 AI 直接对 AI 说一句话

操作 2：查询数据

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

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

操作 3：插入数据

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

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

操作 4：导出数据

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

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

效果对比

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

步骤 没有 MCP 有 MCP
第 1 步 打开数据库客户端 直接对 AI 说
第 2 步 输入密码连接 ---
第 3 步 写 SQL ---
第 4 步 执行 SQL ---
第 5 步 复制结果 ---
第 6 步 粘贴给 AI 分析 ---
第 7 步 等待 AI 分析 AI 直接返回结果 + 分析
合计 7 步，人工中转 1 步，全自动

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：连接数据库失败

常见原因 处理思路
MySQL 未启动 macOS：brew services start mysql；Linux：systemctl start mysql
密码错误 核对 MYSQL_PASSWORD 与真实密码一致
Docker 内连宿主机 容器内访问宿主机 MySQL 时，主机名可用 host.docker.internal 代替 localhost（视环境而定）

问题 4：如何移除 MCP 配置

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

八、本章小结

三节回顾

节 核心问题 核心答案
大语言模型的局限 AI 为什么不能操作数据库？ AI 像「被关在房间里的天才」------能说不能做
MCP 的介绍 MCP 是什么？ AI 世界的 USB-C，统一模型与外部工具的连接方式
MCP 的安装与使用 怎么让 AI 操作数据库？ 安装 MCP Server、配置连接、用自然语言直接操作

从 Skill 到 MCP：能力递进

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

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

参考链接

相关推荐
码上有光11 小时前
MySQL——复合查询
android·数据库·mysql·期末快速复习
yh弓长11 小时前
Redis的string类及基础指令
数据库·redis·缓存
蜡台11 小时前
从mysql的data目录中恢复数据库
数据库·mysql·adb
andafaAPS11 小时前
安达发|橡胶行业自动排产软件：“人脑排产“到“AI智控“的破局之路
运维·数据库·人工智能·安达发aps·自动排产软件·计划排产软件·自动排单软件
极光代码工作室11 小时前
基于NLP的论文智能分析系统
深度学习·机器学习·ai·自然语言处理·系统设计
不剪发的Tony老师11 小时前
Databasus：一个免费开源的数据库备份管理平台
数据库
张忠琳11 小时前
【vllm】（v1 Sample）vLLM V1 Sample—Part 3 投机采样拒绝器与Triton Kernel
java·数据库·vllm
努力成为AK大王12 小时前
从前端到数据库：一个 Web 项目的完整通信链路解析
前端·数据库·ajax·jdbc
辞忧九千七12 小时前
B+树核心原理+MySQL索引底层实战全解
数据结构·b树·mysql
热门推荐
01GitHub 镜像站点02Codex 接入 DeepSeek API 完整配置文档03【踩坑记录 | 第一篇】微软商店无法使用时，如何手动安装 OpenAI Codex？附`.msix`文件系统错误解决方法04裂开！ChatGPT 居然开始要手机号验证，附详细解决方法05CC-Switch & Claude 基于 Linux 服务器安装使用指南06【AI】2026 年具身智能模型和世界模型总结07Codegraph 实战：用知识图谱让 AI 编程效率翻倍08几个好用的ip纯净度检测网站09LLM Wiki：让大模型替你打理知识库的完整指南10给 Claude Code 装上“技能库”和“眼睛”：配置 Skills 与图片识别实战