oracle-mcp-server-helper

Creates LangChain BaseTool wrappers for Oracle SQL queries and vector search via oracledb.

4.3k|807|Updated Jan 16, 2024
One-click install
npx skills add https://github.com/oracle-devrel/oracle-ai-developer-hub --skill oracle-mcp-server-helper
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: oracle-mcp-server-helper
Source: https://github.com/oracle-devrel/oracle-ai-developer-hub/tree/main/build-paths/skills/oracle-mcp-server-helper
Command: npx skills add https://github.com/oracle-devrel/oracle-ai-developer-hub --skill oracle-mcp-server-helper

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires oracledb>=2.5, langchain-core>=0.3, langchain-community>=0.3.

What problem does it solve?

You need a safe, consistent way for an LLM agent to inspect and query a live Oracle database schema during inference, without forcing the entire project to depend on an external MCP server transport.

Core Features & Use Cases

  • LangChain tool scaffolding: Creates BaseTool subclasses for list_tables, describe_table, run_sql, and vector_search that call Oracle via oracledb.
  • Configurable tool safety: Supports sql_mode with a default read_only posture and guardrails against mutating SQL unless explicitly enabled.
  • Agent-ready tool registry: Provides a cached tool_registry.py so an agent loop can load tools efficiently with a stable schema surface.

Quick Start

Configure your database connection in target_dir/.env (DB_DSN, DB_USER, DB_PASSWORD) and ask your agent tier to bind the tools returned by target_dir/src/<package_slug>/tool_registry.py.

Frequently Asked Questions about oracle-mcp-server-helper

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I let a LangChain agent query an Oracle database during inference?

You can let a LangChain agent query an Oracle database by binding LangChain BaseTool subclasses that call oracledb to list tables, describe schema, run SQL, and perform vector search directly during inference time.

Can I use LangChain tools to perform vector search against an Oracle database?

Yes, you can use LangChain tools to perform vector search against an Oracle database by utilizing the provided vector_search BaseTool, which executes retrieval operations over OracleVS-backed collections inside your Python projects.

How do I prevent an LLM SQL agent from running mutating queries on my Oracle schema?

You can prevent an LLM SQL agent from running mutating queries by configuring the sql_mode environment variable with a default read_only posture, which enforces guardrails against mutating SQL unless explicitly enabled.

Do I need an external MCP server transport to inspect an Oracle schema with an LLM agent?

No, you do not need an external MCP server transport to inspect an Oracle schema with an LLM agent, because this approach scaffolds local MCP-compatible tool functions with deterministic oracledb access directly within your Python project.

What is the best way to securely expose live Oracle schema tools to an agent loop?

The best way to securely expose live Oracle schema tools to an agent loop is by loading a cached tool registry that provides a stable schema surface, configurable allowed tool restrictions, and safe SQL modes via environment variables.

What dependencies are required to run Oracle SQL agents with LangChain?

To run Oracle SQL agents with LangChain, you need oracledb version 2.5 or higher for database access, along with langchain-core and langchain-community version 0.3 or higher for the agent tool scaffolding.