什麼是Oracle MCP Server?

Oracle MCP Server是一個專為Oracle數據庫設計的交互服務，它允許用戶通過簡單的命令查詢數據庫結構、執行SQL操作，並即時獲取結果。該服務特別適合需要頻繁與Oracle數據庫交互的非技術人員使用。

如何使用Oracle MCP Server?

使用前需要配置數據庫連接信息，然後通過支持MCP協議的客戶端(如Cursor IDE)發送命令即可。服務提供三種主要工具：查看錶列表、查看錶結構和執行SQL語句。

適用場景

適用於數據分析師快速查看數據庫結構、開發人員調試SQL語句、管理員執行簡單數據庫操作等場景。特別適合需要即時獲取數據庫信息的應用。

主要功能

表列表查詢一鍵獲取數據庫中所有表的名稱列表，方便快速瞭解數據庫結構

表結構描述詳細展示指定表的列信息、數據類型、約束條件等，幫助理解表設計

SQL執行支持執行SELECT查詢(返回CSV格式結果)和INSERT/UPDATE/DELETE操作(返回影響行數)

即時通信基於Server-Sent Events (SSE)技術，確保操作結果的即時返回

優勢與侷限性

優勢

簡單易用：通過簡單命令即可完成複雜數據庫操作

即時性強：基於SSE技術，結果返回迅速

安全性高：內置連接池管理和SQL注入防護

兼容性好：支持各種Oracle數據庫版本

侷限性

僅支持Oracle數據庫，不兼容其他數據庫系統

複雜查詢結果以CSV格式返回，可視化程度有限

需要預先配置數據庫連接信息

如何使用

配置數據庫連接

在application.yml文件中設置Oracle數據庫的連接信息，包括主機、端口、服務名、用戶名和密碼

配置Cursor IDE

在Cursor IDE的MCP服務器設置中添加Oracle MCP Server的URL

啟動服務

使用Maven命令啟動Oracle MCP Server服務

發送命令

在Cursor IDE中通過MCP協議發送命令與數據庫交互

使用案例

探索數據庫結構新接觸一個數據庫時，快速瞭解其中包含哪些表及各表的結構

數據查詢驗證驗證SQL查詢語句的正確性和返回結果

快速數據修改對數據庫進行簡單的數據插入或更新操作

常見問題

連接數據庫時出現錯誤怎麼辦?

執行SQL語句沒有返回結果?

如何保護數據庫密碼安全?

支持哪些Oracle數據庫版本?

🚀 Oracle MCP 服務器

本項目是一個基於 spring-ai-mcp-server-webmvc-spring-boot-starter 的 Oracle 數據庫操作實現的 Model Context Protocol (MCP) 服務。它提供了一系列實用工具，可通過 MCP 協議與 Oracle 數據庫進行交互，並利用 Server-Sent Events (SSE) 實現即時通信，為數據庫操作帶來了高效與便捷。

🚀 快速開始

先決條件

JDK 17
Maven 3.6+
Oracle 數據庫實例
MCP 服務器環境
Cursor IDE

配置

1. 數據庫配置

創建或修改 application.properties 或 application.yml，添加以下設置：

oracle:
  connectionString: jdbc:oracle:thin:@//your-oracle-host:1521/your-service-name
  username: your-username
  password: your-password

2. Cursor MCP 配置

在你的 Cursor IDE 中配置 MCP 服務器設置：

{
  "mcpServers": {
    "oracle-mcp-server": {
      "url": "http://{server-ip}:{server-port}/sse",
      "enabled": true
    }
  }
}

此配置：

設置 MCP 服務器名稱為 "oracle-mcp-server"
配置服務器 URL 為 "http://{server-ip}:{server-port}/sse"
- 替換 {server-ip} 為你服務器的 IP 地址
- 替換 {server-port} 為你服務器的端口號
啟用 MCP 服務器以便在 Cursor 中使用