---
title: "安装 SQL Server 插件"
summary: "从 gemini-cli-extensions/sql-server 安装 sql-server@sql-server，通过 MSSQL_* 参数连接数据库。本地 MCP 服务名为 sql_server。"
category: skills
level: intermediate
surfaces: [cli, app]
tags: ["plugins", "SQL Server", "MCP", "sql-server@sql-server"]
canonical: /tips/sqlserver-codex-plugin/
---

# 安装 SQL Server 插件

从 gemini-cli-extensions/sql-server 安装 sql-server@sql-server，通过 MSSQL_* 参数连接数据库。本地 MCP 服务名为 sql_server。

从 gemini-cli-extensions/sql-server 安装 sql-server@sql-server，通过 MSSQL_* 参数连接数据库。本地 MCP 服务名为 sql_server。

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

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

```bash
export MSSQL_DATABASE=YOUR_MSSQL_DATABASE
export MSSQL_USER=YOUR_MSSQL_USER
export MSSQL_PASSWORD=YOUR_MSSQL_PASSWORD
# 可选：MSSQL_HOST（默认 localhost）、MSSQL_PORT（默认 1433）
```

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

清单 `.claude-plugin/marketplace.json` 的 name 是 `sql-server`，插件 name 也是 `sql-server`（`plugin.json` 0.1.6）。Toolbox 预置是 `mssql`，MCP 表名却是 `sql_server`：

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

IDE 扩展没有 `/plugins`。

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


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

## 来源

- [gemini-cli-extensions/sql-server](https://github.com/gemini-cli-extensions/sql-server)
- [MCP Toolbox · Microsoft SQL Server prebuilt](https://mcp-toolbox.dev/integrations/mssql/prebuilt-configs/microsoft-sql-server/)
- [MCP Toolbox · SQL Server using MCP](https://mcp-toolbox.dev/documentation/connect-to/ides/mssql_mcp/)