mcpField
O
OracleDB MCP Server

OracleDB MCP Server

本地服务
github.com/rahgadda数据库3578 周前更新
代码仓库

关于 OracleDB MCP Server

OracleDB MCP Server 将配置的 Oracle Database 表和列提供为 LLM 上下文，并支持通过提示词生成 SQL 和返回查询结果。它面向需要让 MCP 客户端访问受限数据库结构并执行查询的场景。

主要功能

  1. 01提供配置的表与列作为上下文
  2. 02通过提示词生成 SQL
  3. 03执行查询并返回结果
  4. 04表与列白名单配置
  5. 05可配置查询结果条数上限

适用场景

  1. 01让 LLM 根据数据库结构生成查询
  2. 02限定可访问的表和列
  3. 03通过客户端查询 Oracle Database

MCP 相关

该 MCP 服务向 MCP 客户端提供 Oracle Database 的配置表和列上下文，并支持生成 SQL、执行查询及返回结果。

#oracledb#mcp-server#database-integration

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "oracledb_mcp_server": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/inspector"
      ]
    }
  }
}
启动命令npx -y @modelcontextprotocol/inspector

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@modelcontextprotocol/inspector

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

OracleDB MCP 服务

smithery badge MseeP.ai Security Assessment Badge

概述

  • 此项目将安装 MCP - Model Context Protocol Server，为大模型提供已配置的 Oracle Database 表和列作为上下文。
  • 使用此项目，我们可以让大模型与 Oracle Database 交互、生成 SQL 语句，并通过大模型提示词返回结果。

安装

  • 安装软件包 
    pip install oracledb_mcp_server
  • 在某个文件夹中创建 .env，至少设置 Oracle DB Connection String。可在此处找到示例文件。
  • 在上述文件夹中运行 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://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 许可证条款授权。

演示

README 配图

Github 星标

Star History Chart

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。