MCP Oracle Server

该项目是一个Node.js服务器。它通过模型上下文协议（MCP）提供了与Oracle数据库交互的工具。允许在安全可控的方式下运行SELECT查询、描述表结构以及列出连接用户可用的所有表。

它有什么用途？

• 在Oracle数据库上运行SELECT查询。
• 描述任何Oracle表的结构。
• 列出连接用户可用的所有表。
• 轻松地将Oracle数据库与支持MCP的工具集成。

需求

• Node.js >= 18
• 访问Oracle数据库
• 配置Oracle连接环境变量：
  • ORACLE_USER
  • ORACLE_PASSWORD
  • ORACLE_HOST
  • ORACLE_PORT
  • ORACLE_DATABASE

安装

1. 克隆仓库：

   git clone https://github.com/YrsonHTM/mcp-oracle-server.git
   cd mcp-oracle-server
   

2. 安装依赖项：

   npm install
   

使用方法

启动服务器

npm start

服务器将启动并准备好通过标准输入输出接收MCP命令。

可用工具

• execute_query 在Oracle中运行SELECT查询。
• describe_table 描述表的结构。
• list_tables 列出所有用户可用的表。

在Cursor中的使用示例

您可以将此服务器与Cursor集成，从Cursor界面本身与您的Oracle数据库进行交互。

1. 配置文件 mcp.json

创建（或编辑）位于路径 c:\Users\<您的用户名>\.cursor\mcp.json（Windows）或 ~/.cursor/mcp.json（Linux/Mac）的文件 mcp.json。配置示例如下：

{
  "mcpServers": {
    "oracle-db": {
      "command": "node",
      "args": ["您安装服务器的位置: 如 C:\\mcp-oracle-server\\server.js"],
      "env": {
        "ORACLE_HOST": "服务器主机名: 如10.10.10.10",
        "ORACLE_PORT": "端口: 如1521",
        "ORACLE_DATABASE": "数据库名称: 如pruebadb",
        "ORACLE_USER": "用户名: 如admin",
        "ORACLE_PASSWORD": "密码: 如1234"
      }
    }
  }
}

• 根据您的环境和数据库更改路径和凭据。
• 确保到 server.js 的路径是正确的。

2. 在Cursor中添加MCP服务器

• 打开Cursor。
• 前往模型上下文协议（MCP）配置。
• 点击“添加MCP服务器”并选择您配置的名称（如 oracle-db）。
• 从Cursor启动服务器或手动使用 npm start 启动。

3. 从Cursor使用工具

现在，您可以直接从Cursor界面使用您配置的MCP服务器来运行查询、描述表和列出表。

注意事项

• 该服务器仅允许SELECT查询以防止意外修改数据库。
• 如果您遇到Oracle连接问题，请确保环境变量配置正确。

许可证

MIT