Oracle MCP Server 本地部署保姆级教程

Oracle 数据库也可以通过大语言模型使用自然语言查询了！Oracle SQLcl 中集成了 MCP Server 并可以本地部署。

先从官网抄一下 Oracle MCP Server 相关介绍：

模型上下文协议（MCP）于 2024 年 11 月由 Anthropic 推出，一经推出就受到了病毒式的欢迎。在 MCP 问世之前，大型语言模型 (LLM) 一直无法与外部数据源和 API 直接交互。取而代之的是，应用层负责通过使用模型来丰富用户问题的附加信息，从而协调上下文增强。MCP 的爆炸式增长源于用于向 LLM 添加上下文的协议的标准化。没有这样的协议意味着每个工具、每个应用程序接口（API）等都必须为每个平台或集成创建定制的实施方案，以提供相同的功能。这往往导致工具和供应商之间的重复劳动，要求开发人员为每个 LLM 提供商编写定制代码。

甲骨文对MCP进行了评估，并将其集成到我们的核心开发人员工具中，使甲骨文数据库可立即在任何支持MCP的平台上使用。这种集成可通过我们的现代 Oracle 数据库命令行 Oracle SQLcl 实现。

Oracle SQLcl 是 Oracle 数据库的命令行界面 (CLI)，与 VS Code 的 Oracle SQL Developer 扩展等流行工具一起提供。它现在可以作为 MCP 服务器运行，并提供 MCP 工具，允许人工智能助手安全地连接到 Oracle 数据库。 SQLcl 可管理最终用户机器上的凭证，并运行 SQL 和 PL/SQL 查询和脚本。

允许任何 LLM 访问数据库都需要考虑现有的安全因素。

一个主要的问题是未经授权的数据暴露，因为 LLM 会根据输入数据处理和生成响应，这可能会无意中允许访问非预期的数据库表和详细信息。

Oracle 数据库专业人员和管理员应确保我们的 MCP 服务器所使用的数据库连接是根据数据库用户完成手头工作所需的最低权限定义的。这将限制 LLM 的访问权限。

Oracle 建议，在允许 LLM 直接访问生产数据库时要格外谨慎；相反，应使用经过消毒的只读副本或专用数据子集。定期审计 LLM 执行的查询，以发现异常情况或访问受限数据的尝试。

以下是具体的安装配置步骤：

一、Oracle SQLcl 安装配置

1、下载 Oracle SQLcl

官网下载地址：

https://www.oracle.com/database/sqldeveloper/technologies/sqlcl/download/

2、安装 Oracle SQLcl

下载回来是个压缩文件，直接解压即可使用，前提是需要提前安装JDK8以上。

3、测试 Oracle SQLcl

进入解压文件夹的bin，执行 sql -V 查看SQLcl版本，正常输出即可。

cd bin
./sql -V       

SQLcl：发行版 25.2.2.0 Production 工作版本：25.2.2.199.0918

4、连接数据库测试

./sql sys/oracle@192.168.192.21:1521/testdb as sysdba

SQLcl: 发行版 25.2 Production, 发行日期 周四 7月 24 09:48:55 2025
版权所有 (c) 1982, 2025, Oracle。保留所有权利。
已连接到:
Oracle Database 12c Enterprise Edition Release 12.2.0.1.0 - 64bit Production

至此Oracle SQLcl安装测试完毕。

二、MCP Server 的配置

1、配置数据库连接

-save 参数为连接的名称：cline_mcp，可以根据需要自己起个名字。

SQL> conn -save cline_mcp -savepwd sys/oracle@192.168.192.21:1521/hbgdb as sysdba
Name: cline_mcp
Connect String: 192.168.192.21:1521/hbgdb
User: sys
Password: ******
Connected.
SQL>

2、检查 MCP Server 状态

当SQLcl MCP服务器成功启动时，它会显示一条包含启动时间戳的确认消息，表明它已准备好接受来自MCP客户端的连接。

您可以在终端上验证此消息，以确认服务器是否已就绪。以下是服务器启动时的示例消息：

./sql -mcp
---------- MCP SERVER STARTUP ----------
MCP Server started successfully on Thu Jul 24 10:09:07 CST 2025
Press Ctrl+C to stop the server
----------------------------------------

3、安装 vscode 插件

（1）安装vscode：如没有vscode，先从这个地址下载并安装VS Code：https://code.visualstudio.com/download

（2）安装vscode 插件：打开VS Code侧边栏，找到扩展。输入 Cline 搜索，点击安装，然后点击信任发布者并安装。也可以选择Cline Chinese安装中文版，功能一样。

4、配置 API keys 和 AI 模型

安装完成后点击侧边栏的 Cline 图标，即进入到 Cline 界面。

在 Cline 界面选择 Use your own API key 按钮，即可进入以下界面。这里根据自己的情况选择，我选择了DeepSeek，模型选择 deepseek-chat。

到DeepSeek网站（https://platform.deepseek.com/api_keys）点击创建 API Key。点击复制，填到上图的 DeepSeek API key 处。注意此key只显示一次，不要泄露给别人。

配置完成点击 Done 完成配置。

五、配置 SQLcl MCP Server

1、点击底部的 Manage MCP Servers 图标

2、在弹出的界面中点击齿轮图标

3、配置 MCP 服务器

点击 Configure MCP Servers 按钮。在编辑区可以进行MCP服务器参数配置。配置完成点击 Done。

{
  "mcpServers": {
    "SQLcl": {
      "command": "/Users/Dylan/Documents/sqlcl/bin/sql ",
      "args": [
        "-mcp","sys/oracle@192.168.192.21:1521/hbgdb as sysdba"
      ],
      "disabled": false,
      "timeout": 300
    }
  }
}

配置完成，可看到配置的MCP Server。

至此完成配置。可以愉快的玩耍了。

例如，我问当前连接了哪个数据库，提问可以是中文也可以是英文。下面给出的信息。

我当前配置文件中连接的哪个数据库？

你可以要求他连接到此数据库，然后再进行相应的查询。

当需要询问是否继续的时候他询问你是否同意或拒绝。

当需要执行命令的时候会也是询问运行命令或拒绝。如下图所示。

点击 Run Command 按钮会执行命令并返回结果。

更多乐趣，等你发现。