---
title: "安装 MySQL 插件"
summary: "从 gemini-cli-extensions/mysql 安装 mysql@mysql，通过 MYSQL_DATABASE、MYSQL_USER 等参数连接 MySQL 实例。"
category: skills
level: intermediate
surfaces: [cli, app]
tags: ["plugins", "MySQL", "MCP", "mysql@mysql"]
canonical: /tips/mysql-codex-plugin/
---

# 安装 MySQL 插件

从 gemini-cli-extensions/mysql 安装 mysql@mysql，通过 MYSQL_DATABASE、MYSQL_USER 等参数连接 MySQL 实例。

从 gemini-cli-extensions/mysql 安装 mysql@mysql，通过 MYSQL_DATABASE、MYSQL_USER 等参数连接 MySQL 实例。

这是 [gemini-cli-extensions/mysql](https://github.com/gemini-cli-extensions/mysql) 的 Codex 专节。插件把 MCP Toolbox 的预置 `mysql` 封装为插件，用数据库用户连任意 MySQL 实例，用于查看 schema 和执行 SQL。认证是库用户，**不是** GCP ADC。

要 Codex **v0.150.0+**，本机有 Node / npx。先有一台能连的 MySQL，再在启动 Codex 的同一 shell 里导出：

```bash
export MYSQL_DATABASE=YOUR_MYSQL_DATABASE
export MYSQL_USER=YOUR_MYSQL_USER
export MYSQL_PASSWORD=YOUR_MYSQL_PASSWORD
# 可选：MYSQL_HOST（默认 localhost）、MYSQL_PORT（默认 3306）
```

不要把密码写进 `http_headers`。该 stdio 服务 **不要** `mcp login`。

清单 `.claude-plugin/marketplace.json` 的 name 是 `mysql`，插件 name 也是 `mysql`（`plugin.json` 0.1.6）。Toolbox 预置和 MCP 表名都是 `mysql`：

```bash
codex --version
codex plugin marketplace add gemini-cli-extensions/mysql
codex plugin add mysql@mysql
codex plugin list
codex mcp list
```

IDE 扩展没有 `/plugins`。

插件会登记一台 **stdio** MCP，表名是 `mysql`。command 是 `npx`，args 指定 `@toolbox-sdk/server@1.9.0 --prebuilt mysql --stdio`。**不要** `codex mcp login mysql`。插件已经带 MCP 时，不要再 `codex mcp add mysql -- npx @toolbox-sdk/server` 叠一张用户层表。


可选：`codex plugin marketplace upgrade mysql` 后再 `plugin add` 一次。0.154 起先看当前会话的 `/plugins` 和 `/mcp`；没有再新开。`codex mcp list` 里应有 `mysql`。连接失败先看 `MYSQL_DATABASE` / `MYSQL_USER` / `MYSQL_PASSWORD` 是不是进了同一进程，以及 npx 能不能拉到 Toolbox 1.9.0。发行仍是 Beta（pre-v1.0）。`execute_sql` 能改数据，保持工具调用审批。

## 来源

- [gemini-cli-extensions/mysql](https://github.com/gemini-cli-extensions/mysql)
- [MCP Toolbox · MySQL prebuilt](https://mcp-toolbox.dev/integrations/mysql/prebuilt-configs/mysql/)
- [MCP Toolbox · MySQL using MCP](https://mcp-toolbox.dev/documentation/connect-to/ides/mysql_mcp/)