站長阿川

站長阿川私房教材:
學 JavaScript 前端,帶作品集去面試!

站長精心設計,帶你實作 63 個小專案,得到作品集!

立即開始免費試讀!

為了使企業能夠針對儲存在 Oracle 資料庫中的企業資料建立代理應用程式,我們發布了模型上下文協定 (MCP) 伺服器

Oracle MCP Server 已整合到 Oracle 的核心開發工具中,支援在任何支援MCP 的平台上立即使用 Oracle 資料庫。此整合透過Oracle SQLcl (一種新的 Oracle 資料庫命令列)實現。

影像.png

SQLcl MCP Server 提供了一套工具集,可增強 AI 應用與 Oracle 資料庫的整合。這些工具抽象化了用於各種資料庫操作的 SQLcl 命令,使 AI 模型能夠自主管理資料庫,讓您能夠專注於策略目標,而無需手動進行命令列操作。

此外,這些工具透過自然語言介面實現高級工作流程,使人工智慧系統能夠演示資料庫、管理大規模資料遷移、執行複雜的分析查詢以及自動執行管理任務。最後,SQLcl MCP Server 消除了直接手動輸入的需要,使人工智慧應用程式能夠獨立執行以前需要高水平專業知識和努力的複雜資料庫操作。

目前,SQLcl MCP Server 提供以下工具:

  list-connections:マシンに保存されているすべての Oracle データベース接続を検出し、一覧表示します。
  connect:指定した名前付き接続の 1 つへの接続を確立します。
  切断:現在アクティブな Oracle データベース接続を終了します。
  run-sql:接続されたデータベースに対して標準の SQL クエリと PL/SQL コード ブロックを実行します。
  run-sqlcl: SQLcl 固有のコマンドと拡張機能を実行します。

構成.png

如果您是開發者,正在尋找更有效率地利用 AI 技術處理企業資料的新方法,那麼您一定知道模型情境協定 (MCP) 為何如此火爆。 MCP 的定位類似於 USB-C,用於將大型語言模型 (LLM) 與 AI 工具整合。現在,隨著 Oracle 資料庫模型上下文協定伺服器 (MCP Server) 的推出(可透過 Oracle SQLcl 存取),您可以安全地將 AI 助理和 LLM 連接到 Oracle 資料庫,而無需為每個 AI 工具或 LLM 建立自訂整合。這表示您現在可以從任何支援 MCP 的平台存取 Oracle 資料庫。

因此,我在 MacBook 上安裝了SQLcl MCP Server和 Anthropic 開發的高效能互動式 AI Cloud Desktop ,並嘗試使用自然語言查詢 Oracle 資料庫並建立 ER 圖、圖形和儀表板。

■ 配置圖

在您的 MacBook 上安裝 SQLcl MCP Server 和 Interactive AI Claude 以連接到 Oracle 資料庫。

構成.png

首先,請按照配置圖所示建立一個 Oracle 資料庫,並對其進行配置,以便它可以透過 SQL 與 MacBook 通訊。

此外,Oracle 資料庫中安裝了一個範例模式,以便可以使用資料執行查詢。

  • 參考

- Oracle 資料庫建立: Oracle Exadata 雲端基礎架構 X11M 建立

- 範例資料輸入:安裝 Oracle 資料庫範例模式

- FastConnect 連線: NEC Inzai 資料中心的 Oracle FastConnect L2 連接

注意

允許大型語言模型 (LLM) 存取您的資料庫會帶來重大的安全風險:因為 LLM 使用輸入資料來產生回應,因此意外的表或敏感資訊可能會被意外暴露。

為了減輕這些風險,請遵循以下安全措施:

  • 分配最低權限: LLM 使用的資料庫使用者帳戶應具有執行任務所需的最低權限。這種方法限制了 LLM 的存取範圍。

  • 避免生產資料庫存取: LLM 不應被授予對生產資料庫的直接存取權限;相反,它應該使用經過清理的唯讀副本或專用資料子集。

  • 審計 LLM 活動:定期審計 LLM 執行的查詢,以偵測異常情況以及存取受限資料的嘗試。為了支援您的稽核工作,SQLcl MCP Server 提供了以下內建監控功能:

  • 會話追蹤:在 VSESSION.MODULE 中輸入正在使用的 MCP 用戶端,在 V$SESSION.ACTION 中輸入 LLM 的名稱。

  • 活動日誌:建立一個名為 DBTOOLS$MCP_LOG 的表,記錄所有互動和 SQL 執行。

  • 查詢辨識: LLM 透過 MCP 伺服器上的 SQLcl 工具產生的所有查詢都將包含以下註釋,以便在日誌中輕鬆辨識/* LLM in use ... */

有關監控的更多訊息,請參閱監控 SQLcl MCP 伺服器

■ 準備環境

● 安裝所需軟體

若要使用 SQLcl MCP 伺服器,您必須在系統上安裝下列軟體:

Oracle SQLcl,版本 25.2.0 或更高版本

- Java 執行時期環境 (JRE) 版本 17 或更高版本

1)安裝SQLcl和JRE / JDK

請按照以下說明安裝 SQLcl 和 JRE。

・參考:在 MacBook 上安裝 SQLcl 和 JRE/JDK

2)檢查SQLcl安裝

驗證您可以執行 SQLcl 命令

shirok@macbook~ % sql /nolog

  Warning: ORACLE_HOME must be database version 23 or later
          or must be a 23c compatible instant client
          Thick driver unavailable for use.

  SQLcl: 月 8月 04 20:29:56 2025のリリース25.2 Production

  Copyright (c) 1982, 2025, Oracle.  All rights reserved.

SQL>

3)檢查JRE安裝

檢查 Java 版本

shirok@macbook~ % java -version
  java version "22" 2024-03-19
  Java(TM) SE Runtime Environment (build 22+36-2370)
  Java HotSpot(TM) 64-Bit Server VM (build 22+36-2370, mixed mode, sharing)

● 設定資料庫連接

SQLcl MCP 伺服器依賴目錄中的連接儲存中儲存的預先配置連接,可以使用 ~/.dbtools 進行管理。

若要建立與 MCP 相容的已儲存連接,請執行類似以下範例的命令:

1)SQLcl連接

shirok@macbook~ % sql /nolog

Warning: ORACLE_HOME must be database version 23 or later
         or must be a 23c compatible instant client
         Thick driver unavailable for use.

SQLcl: 火 7月 29 19:23:06 2025のリリース25.2 Production

Copyright (c) 1982, 2025, Oracle.  All rights reserved.

SQL>

2)建立與 MCP 相容的已儲存連接

使用以下命令連接到 Oracle 資料庫:

SQL> conn -save cline_mcp -savepwd HR/Password@//10.10.1.185:1521/PDB.clientsubnet.vcnexatokyo.oraclevcn.com
  名前: cline_mcp
  接続文字列: //10.10.1.185:1521/PDB.clientsubnet.vcnexatokyo.oraclevcn.com
  ユーザー: HR
  パスワード: ******
  接続しました.

SQL> exit
  Oracle Database 19c EE High Perf Release 19.0.0.0.0 - Production
  Version 19.24.0.0.0から切断されました

3)檢查~/.dbtools目錄

SQLcl MCP 伺服器儲存在 ~/.dbtools 目錄中的連接儲存中,並透過在 dbtools.properties 檔案中設定來建立連接資訊。

shirok@macbook~ % ls -l ~/.dbtools
total 0
drwx------  3 shirok  staff  96 Jul 29 18:15 connections

shirok@macbook ~ % cat .dbtools/connections/0HRl7egbDJvBqNDvpYtVHA/dbtools.properties
    name=cline_mcp
    type=ORACLE_DATABASE
    connectionString=//10.10.1.185\:1521/PDB.clientsubnet.vcnexatokyo.oraclevcn.com
    userName=HR

4)啟動並檢查MCP伺服器

shirok@macbook~ % sql -mcp

Warning: ORACLE_HOME must be database version 23 or later
         or must be a 23c compatible instant client
         Thick driver unavailable for use.

---------- MCP SERVER STARTUP ----------
MCP Server started successfully on Tue Jul 29 18:20:28 JST 2025
Press Ctrl+C to stop the server
----------------------------------------

■啟動 SQLcl MCP 伺服器

SQLcl MCP 伺服器設計為透過 MCP 用戶端應用程式自動啟動和管理。

設定您首選的用戶端(例如 Claude Desktop 或 Cline),並在需要時啟動伺服器。配置完成後,MCP 用戶端將自主處理伺服器啟動、生命週期管理,並在會話完成後乾淨終止,從而實現與 Oracle 資料庫的自然互動。

若要設定 MCP 用戶端,必須將客戶端指向伺服器的位置。以下主題提供了配置兩種常見 MCP 用戶端的具體說明:

MCPサーバーとして Claudeデスクトップを構成
MCPクライアントとして VS Code で Cline を構成

● Claude 桌面設置

若要為 SQLcl MCP Server 設定 Claude Desktop,請依照下列步驟操作:配置後,Claude Desktop 將自動管理 SQLcl MCP Server 並與 Claude 互動以執行 Oracle 資料庫操作。

安裝 Claude 桌面版。請參閱安裝 Claude 桌面版進行建立。

● 系統需求

macOS:macOS 11(大蘇爾)以上

Windows:Windows 10 或更高版本

● 安裝步驟

造訪Claude 的下載頁面

為您的作業系統選擇適當的版本。

對於 Mac 用戶:按一下 macOS

11_ClaudeDesktopインsutoru01.jpg

1)開啟檔案並完成安裝。

11_ClaudeDesktopinsutoru02.jpg

11_ClaudeDesktopインsutoru03.jpg

2) 從您的應用程式資料夾(Mac)或開始功能表(Windows)啟動 Claude。

11_ClaudeDesktopインsutoru04.jpg

3)使用您的帳號登入即可開始。

11_ClaudeDesktopインsutoru06.jpg

4)Claude安裝完成

11_ClaudeDesktopインsutoru08.jpg

● Claude 桌面設置

若要為 SQLcl MCP Server 設定 Claude Desktop,請依照下列步驟操作:配置後,Claude Desktop 將自動管理 SQLcl MCP Server 並與 Claude 互動以執行 Oracle 資料庫操作。

1)下載設定檔。

打開 Claude Desktop,點擊選單,選擇文件,然後點擊設定。

11_ClaudeDesktopイinsutoru10.jpg

在「設定」視窗中,按一下「開發」標籤。

11_ClaudeDesktopイinsutoru11.jpg

按一下編輯設定將設定檔(claude_desktop_config.json)下載到您的電腦。

11_ClaudeDesktopイinsutoru12.jpg

2)編輯設定檔。

在文字編輯器中開啟檔案 claude_desktop_config.json,依照下列格式新增 JSON 設定碼片段,將 SQLclPATH/bin/sql 替換為已安裝的絕對路徑,然後儲存設定檔。

shirok@macbook~ % cat Library/Application\ Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "sqlcl": {
      "command": "/Users/shirok/oracle/sqlcl/bin/sql",
      "args": ["-mcp"]
    }
  }
}

11_ClaudeDesktopイinsutoru13.jpg

3)檢查配置

在提示框中點選搜尋和工具。

11_ClaudeDesktopイinsutoru14.jpg

現在您應該會看到 SQLcl MCP Server 工具已列出並啟用。如有必要,請重新啟動 Claude Desktop 以使變更生效。

11_ClaudeDesktopイinsutoru15.jpg

■ 使用案例和提示範例

現在,讓我們啟動 MCP 伺服器並用自然語言進行查詢。

● MCP 伺服器啟動

使用以下命令啟動 MCP 伺服器:

要停止它,請按 Ctrl+C。

shirok@macbook~ % sql -mcp

Warning: ORACLE_HOME must be database version 23 or later
         or must be a 23c compatible instant client
         Thick driver unavailable for use.

---------- MCP SERVER STARTUP ----------
MCP Server started successfully on Tue Jul 29 18:20:28 JST 2025
Press Ctrl+C to stop the server
------

●Claude Inquiry:LLM 自我介紹

現在しようされているLLMを教えてください

82_CLAUDE問合せ_LLM紹介.png

● Claude 問:什麼是 MCP 伺服器?

OracleのMCPサーバーとはどのようなものでどんなことできるのでしょうか?

[ 82_CLAUDE問合せ_WhatsMCP.png ](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F109087%2F72016e


原文出處:https://qiita.com/shirok/items/9fe46cd707a3fb43a796


共有 0 則留言


精選技術文章翻譯,幫助開發者持續吸收新知。
站長阿川

站長阿川私房教材:
學 JavaScript 前端,帶作品集去面試!

站長精心設計,帶你實作 63 個小專案,得到作品集!

立即開始免費試讀!