Oracle SQLcl MCP Server实战

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

914fcc7ad57defa7868c3be1ca7fb4f5.jpg

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

sqlcl_mcp_server.png

本期基于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

image.png

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

image.png

sql -V

image.png

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

image.png

3 SQLcl配置MCP

3.1 配置链接参数

sqlcl / as sysdba

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

image.png

3.2 启动MCP

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

image.png

4 配置VS Code

4.1 安装Cline

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

image.png

4.2 配置LLM

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

image.png

4.3 配置MCP

image.png

image.png

image.png

image.png

这里在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。

image.png

5 使用MCP

总结

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