OracleDB MCP 服务器

概述

• 该项目将安装MCP - Model Context Protocol Server ，它为 LLM 提供配置的 Oracle 数据库表/列作为上下文。

• 利用此功能，我们可以使 LLM 与 Oracle 数据库交互、生成 SQL 语句并使用 LLM 提示返回结果。

Related MCP server: MCP Oracle Server

安装

• 安装包

  pip install oracledb_mcp_server

• 在包含Oracle DB Connection String最小值的文件夹中创建 .env 文件。示例文件可在此处获取

• 使用uv run oracledb_mcp_server测试oracledb_mcp_server服务器。

克劳德桌面

• Claud Desktop 的配置详情

  {
    "mcpServers": {
      "oracledb_mcp_server":{
        "command": "uv",
        "args": ["run","oracledb_mcp_server"],
        "env": {
            "DEBUG":"True",
            "COMMENT_DB_CONNECTION_STRING":"oracle+oracledb://USERNAME:PASSWORD@IP:PORT/?service_name=SERVICENAME",
            "DB_CONNECTION_STRING":"oracle+oracledb://USERNAME:PASSWORD@IP:PORT/?service_name=SERVICENAME",
            "TABLE_WHITE_LIST":"ACCOUNTS,CUS_ACC_RELATIONS,CUSTOMERS",
            "COLUMN_WHITE_LIST":"ACCOUNTS.ACC_AAD_ID,CUS_ACC_RELATIONS.CAR_CUS_ID,CUS_ACC_RELATIONS.CAR_AAD_ID,CUSTOMERS.CUS_ID"
        }
      }
    }
  }

配置

• 可用环境变量列表

  • DEBUG ：启用调试日志记录（可选，默认值为 False）

  • COMMENT_DB_CONNECTION_STRING ：用于注释的 Oracle DB 连接字符串。（必需）

  • DB_CONNECTION_STRING ：用于执行查询的 Oracle DB 连接字符串。（必需）

  • TABLE_WHITE_LIST ：列表格式的白名单表名称 [“table1”，“table2”] （必需）

  • COLUMN_WHITE_LIST ：列表格式的白名单表列名称 [“table.column1”，“table.column2”] （必需）

  • QUERY_LIMIT_SIZE ：若未提供，则默认值为 10 条记录（可选默认值为 10）

拦截器

npx @modelcontextprotocol/inspector uv --directory "D:\\MyDev\\mcp\\oracledb_mcp_server" run -m oracledb_mcp_server

贡献

欢迎投稿。
请随时提交拉取请求。

执照

该项目是根据 MIT 许可条款授权的。

演示

Github 星标