什么是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 中使用