OracleDB MCP 服务器

概述

• 此项目将安装 MCP - 模型上下文协议服务器，该服务器提供配置的 Oracle 数据库表/列作为 LLM 的上下文。
• 使用此功能，我们可以使 LLM 与 Oracle 数据库交互，生成 SQL 语句，并使用 LLM 提示返回结果。

安装

• 安装包

  pip install oracledb_mcp_server
  

• 在文件夹中创建 .env 文件，其中包含 Oracle DB 连接字符串 的最小值。 示例文件可在此处获得 here
• 使用 uv run oracledb_mcp_server 从上述文件夹测试 oracledb_mcp_server 服务器。

Claud 桌面

• Claud 桌面的配置详情

  {
    "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

贡献

欢迎贡献。 请随时提交 Pull Request。

许可证

此项目已获得 MIT 许可证的许可。

演示

Github Stars