OracleDB MCP Server
2025.04.14
0
Python数据库交互SQL 生成数据库
OracleDB MCP Server 是一个基于 Model Context Protocol (MCP) 的服务，旨在为大型语言模型 (LLM) 提供配置好的 Oracle 数据库表和列作为上下文。通过该服务，LLM 可以与 Oracle 数据库交互，生成 SQL 语句并通过 LLM 提示返回查询结果。
View on GitHub
Overview
基本能力
产品定位
OracleDB MCP Server 是一个数据库交互工具，专注于为 LLM 提供 Oracle 数据库的上下文信息，并支持通过自然语言生成 SQL 查询。
核心功能
- 数据库上下文提供：将配置好的 Oracle 数据库表和列作为上下文提供给 LLM。
- SQL 生成与执行：支持通过 LLM 提示生成 SQL 语句并执行查询。
- 白名单配置：支持表和列的白名单配置，确保数据安全性。
- 调试支持：提供调试模式，便于开发和测试。
适用场景
- LLM 与数据库交互：适用于需要 LLM 与 Oracle 数据库交互的场景。
- SQL 生成：适用于通过自然语言生成 SQL 查询的场景。
- 数据查询与分析：适用于需要快速查询和分析数据库数据的场景。
工具列表
- oracledb_mcp_server：主服务工具，提供数据库上下文和 SQL 生成能力。
- Claud Desktop：支持通过 JSON 配置 MCP 服务器。
- Interceptor：用于调试和监控 MCP 服务器的工具。
常见问题解答
- 如何配置数据库连接字符串？
- 在
.env文件中配置DB_CONNECTION_STRING和COMMENT_DB_CONNECTION_STRING。 - 如何启用调试模式？
- 设置
DEBUG=True环境变量。 - 如何限制查询结果数量？
- 设置
QUERY_LIMIT_SIZE环境变量。
使用教程
使用依赖
- 确保已安装 Python 和 pip。
- 安装 Oracle 数据库驱动（如
oracledb）。
安装教程
- 安装服务包：
bash pip install oracledb_mcp_server - 创建
.env文件并配置数据库连接字符串。示例文件可参考 GitHub。 - 启动服务：
bash uv run oracledb_mcp_server
调试方式
- 使用 Interceptor 工具调试：
bash npx @modelcontextprotocol/inspector uv --directory "D:\\MyDev\\mcp\\oracledb_mcp_server" run -m oracledb_mcp_server - 启用调试模式：
bash set DEBUG=True uv run oracledb_mcp_server