【技术文档摘要】

OracleDB MCP Server

概述

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

安装

• 安装包

  pip install oracledb_mcp_server
  

• 在文件夹中创建 .env 文件，并至少包含 Oracle DB 连接字符串。示例文件可在此处找到 这里
• 使用 uv run oracledb_mcp_server 测试 oracledb_mcp_server 服务器。

Claud Desktop

• Claud Desktop 配置详情

  {
    "mcpServers": {
      "oracledb_mcp_server":{
        "command": "uv",
        "args": ["run","oracledb_mcp_server"],
        "env": {
            "DEBUG":"True",
            "COMMENT_DB_CONNECTION_STRING":"oracle+oracledb://用户名:密码@IP:端口/?service_name=服务名",
            "DB_CONNECTION_STRING":"oracle+oracledb://用户名:密码@IP:端口/?service_name=服务名",
            "TABLE_WHITE_LIST":"账户,客户账户关系,客户",
            "COLUMN_WHITE_LIST":"账户.ACC_AAD_ID,客户账户关系.CAR_CUS_ID,客户账户关系.CAR_AAD_ID,客户.CUS_ID"
        }
      }
    }
  }
  

配置

• 可用环境变量列表
  • DEBUG: 启用调试日志（可选，默认值为 False）
  • COMMENT_DB_CONNECTION_STRING: 用于注释的 Oracle DB 连接字符串。（必需）
  • DB_CONNECTION_STRING: 用于执行查询的 Oracle DB 连接字符串。（必需）
  • TABLE_WHITE_LIST: 白名单表名列表格式 ["表1", "表2"]（必需）
  • COLUMN_WHITE_LIST: 白名单表-列名列表格式 ["表.列1", "表.列2"]（必需）
  • 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