金大哥 - rahgadda_oracledb_mcp

article

README

🚀 OracleDB MCP 服务器

该项目主要用于安装 MCP - Model Context Protocol Server，此服务器会将配置好的 Oracle 数据库表/列作为上下文提供给大语言模型（LLM）使用。借助该项目，LLM 能够与 Oracle 数据库进行交互，生成 SQL 语句并返回查询结果。

🚀 快速开始

本项目可以让大语言模型与 Oracle 数据库交互，下面为你介绍如何快速开启使用。

✨ 主要特性

安装 MCP - Model Context Protocol Server，为大语言模型提供 Oracle 数据库上下文。
支持大语言模型与 Oracle 数据库交互，生成 SQL 语句并返回结果。

📦 安装指南

安装包

pip install oracledb_mcp_server

配置环境文件

创建包含最小值的 Oracle DB Connection String 的 .env 文件。示例文件可在此处下载 here

测试服务器

使用以下命令测试 oracledb_mcp_server 服务器：uv run 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://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_CONNECTION_STRING | 用于执行查询的 Oracle 数据库连接字符串（必需） | | 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 许可证条款下授权。

rahgadda_oracledb_mcp_server