安装 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 的 Codex 专节。插件把 MCP Toolbox 的预置 mssql 封装为插件,用数据库用户连任意 SQL Server 实例,用于查看 schema 和执行 SQL。认证是库用户,不是 GCP ADC。

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

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-serverplugin.json 0.1.6)。Toolbox 预置是 mssql,MCP 表名却是 sql_server

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 能改数据,保持工具调用审批。

来源