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.