数据库管理-第389期 Oracle SQLcl MCP Server实战（20251113）

作者：胖头鱼的鱼缸（尹海文）
Oracle ACE Pro: Database
PostgreSQL ACE
OpenTenBase ACE

10年数据库行业经验
拥有OCM 11g/12c/19c、MySQL 8.0 OCP、Exadata、CDP等认证
墨天轮MVP，ITPUB认证专家
圈内拥有“总监”称号，非著名社恐（社交恐怖分子）

公众号：胖头鱼的鱼缸
CSDN：胖头鱼的鱼缸（尹海文）
墨天轮：胖头鱼的鱼缸
ITPUB：yhw1809
IFClub：胖头鱼的鱼缸
除授权转载并标明出处外，均为“非法”抄袭

MCP（Model Context Protocol）即模型上下文协议，是由Anthropic推出的开源协议/开放标准，旨在统一大模型与外部数据源和工具之间的通信协议。MCP的主要目的在于解决当前AI模型因数据孤岛限制而无法充分发挥潜力的难题，MCP使得AI应用能够安全地访问和操作本地及远程数据，为AI应用提供了连接万物的接口。
Oracle的SQLcl工具可以通过链接配置并运行连接至Oracle数据库的MCP Server。

本期基于SQLcl MCP Server，结合之前部署的Oracle AI Database 26ai（FREE版本），实现AI大模型对数据库的访问。

1部署SQLcl

1.1下载SQLcl

下载最新版本SQLcl 25.3.1，该版本Linux/Windows通用。

下载地址：
https://www.oracle.com/database/sqldeveloper/technologies/sqlcl/download/

1.2解压软件

unzip sqlcl-25.3.1.311.1257.zip

1.3 安装JDK

SQLcl使用MCP需要Java 17或以上版本。本次下载最新的25.0.1。

下载地址：
https://www.oracle.com/cn/java/technologies/downloads/
下载x64 Compressed Archive

tar -xvf jdk-25_linux-x64_bin.tar.gz

1.4配置环境变量

vim ~/.bash_profile

调整以下内容：

export JAVA_HOME=/home/oracle/jdk-25.0.1
#添加SQLcl对应sql命令路径和JDK对应java命令路径到PATH中
export PATH=$ORACLE_HOME/bin:$JAVA_HOME/bin:/home/oracle/sqlcl/bin:$PATH

1.4测试命令

java --version

sql -V

2 安装sample schema

本次仅部署HR（human_resources）示例schema。

2.1 下载文件

git clone https://github.com/oracle/db-sample-schemas.git

2.2 安装

cd human_resources
sql sys/oracle@127.0.0.1:1521/freepdb1 as sysdba

@hr_install.sql

3 SQLcl配置MCP

3.1 配置链接参数

sqlcl / as sysdba

conn -save mcp_2326 -savepwd sys/oracle@10.10.10.26:1521/freepdb1 as sysdba

3.2 启动MCP

sql -mcp sys/oracle@10.10.10.26:1521/freepdb1 as sysdba 

4 配置VS Code

4.1 安装Cline

打开VS Code，左侧侧边栏选择 扩展（Extensions），搜索栏输入cline，安装Cline Chinese（中文版）。

4.2 配置LLM

这里选择本地通过Ollama部署的qwen3:30b。

4.3 配置MCP

这里在Windows中也部署对应的SQLcl并执行前面Linux中的SQL命令，然后编写MCP配置文件。

{
  "mcpServers": {
    "SQLcl": {
      "command": "D:/sqlcl-25.3.1.311.1257/sqlcl/bin/sql.exe ",
      "args": [
        "-mcp"
      ],
      "disabled": false,
      "timeout": 300
    }
  }
}

保存配置文件左侧即可出现SQLcl MCP。

5 使用MCP

总结

本期采Oracle AI Database 26ai（FREE 版本）作为核心数据库，通过SQLcl运行MCP Server，借助VS Code中的Cline扩展，调用本地Ollama环境部署的QWen3:30B模型，最终完成AI大模型对数据库的访问。
老规矩，知道写了些啥。