Oracle MCP 服务器

一个用于 Oracle 数据库操作的模型上下文协议 (MCP) 服务器实现，构建于 spring-ai-mcp-server-webmvc-spring-boot-starter 之上。此服务提供了一组通过 MCP 与 Oracle 数据库交互的工具，利用服务器发送事件 (SSE) 进行实时通信。

功能

• 列出 Oracle 数据库中的所有表
• 描述表结构（列、数据类型、约束）
• 执行 SQL 语句（SELECT、INSERT、UPDATE、DELETE）
• 安全的数据库连接管理
• 通过 SSE 进行实时通信
• 构建于 spring-ai-mcp-server-webmvc-spring-boot-starter 之上

技术栈

核心依赖

• Spring Boot 3.2.0
• spring-ai-mcp-server-webmvc-spring-boot-starter
• Oracle JDBC Driver
• 模型上下文协议 (MCP) 框架
• Lombok

开发工具

• Java 17
• Maven 3.6+
• Spring Boot 测试框架
• JUnit 5

快速开始

前提条件

• 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 中使用

构建项目

mvn clean install

运行应用程序

mvn spring-boot:run

API 工具

1. 列出表工具

• 名称：list_tables
• 描述：获取 Oracle 数据库中所有表的列表
• 用法：无需参数
• 返回：换行符分隔的表名列表

2. 描述表工具

• 名称：describe_table
• 描述：获取指定表的结构信息
• 参数：tableName - 要描述的表的名称
• 返回：包含表结构的 CSV 格式，包括：
  • 列名
  • 数据类型
  • 可空状态
  • 数据长度
  • 主键信息

3. 执行 SQL 工具

• 名称：execute_sql
• 描述：执行 Oracle SQL 语句
• 参数：sql - 要执行的 SQL 语句
• 返回：
  • 对于 SELECT：查询结果的 CSV 格式
  • 对于 INSERT/UPDATE/DELETE：受影响的行数

实现细节

架构

com.mcp.oracle/
├── config/
│   └── OracleConfig.java         # 数据库配置
├── service/
│   └── OracleService.java        # 核心服务实现
└── OracleApplication.java        # 应用程序入口点

关键组件

1. OracleConfig

   • 处理数据库连接配置
   • 使用 Spring 的 @ConfigurationProperties
   • 安全的密码管理

2. OracleService

   • 实现用于数据库操作的 MCP 工具
   • 管理数据库连接
   • 处理 SQL 执行和结果格式化
   • 实现错误处理和日志记录

3. 连接管理

   • 使用 Oracle 的连接池
   • 实现资源的自动关闭
   • 优雅地处理连接错误

安全注意事项

• 配置中的密码加密
• 连接池管理
• SQL 注入预防
• 错误消息清理

测试

该项目包括全面的单元测试：

mvn test

测试覆盖范围包括：

• 数据库连接
• 表格列出
• 表结构描述
• SQL 执行
• 错误处理

错误处理

该服务实现了强大的错误处理：

• 连接失败
• 无效的 SQL 语句
• 缺少表/列
• 权限问题

贡献

1. Fork 存储库
2. 创建您的功能分支
3. 提交您的更改
4. 推送到分支
5. 创建拉取请求

许可证

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。

支持

如需支持和问题，请在存储库中创建一个 issue。