oracle-sqlplus-mcp

Ein MCP-Server (Model Context Protocol) für Oracle Database, der sqlplus als Verbindungs-Backend verwendet. Es sind keine Oracle Instant Client Node.js-Bindings erforderlich – lediglich eine funktionierende sqlplus-Binärdatei.

Voraussetzungen

• sqlplus muss installiert und im PATH verfügbar sein (wird mit Oracle Instant Client oder dem vollständigen Oracle-Client mitgeliefert)

• Node.js 18+

Related MCP server: oracle-db-mcp

Installation

npm install -g oracle-sqlplus-mcp
# or run directly with npx (no install needed):
npx oracle-sqlplus-mcp

Format des Verbindungs-Strings

username/password@host:port/servicename

Beispiele:

scott/tiger@localhost:1521/ORCL
myuser/mypass@192.168.1.10:1521/XEPDB1
admin/secret@db.example.com:1521/PROD

Claude Desktop-Konfiguration

Fügen Sie dies zu Ihrer claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "oracle": {
      "command": "npx",
      "args": ["-y", "oracle-sqlplus-mcp"],
      "env": {
        "ORACLE_CONNECTION": "username/password@host:port/servicename"
      }
    }
  }
}

Optionale Umgebungsvariablen

Beispiel für einen benutzerdefinierten sqlplus-Pfad

{
  "mcpServers": {
    "oracle": {
      "command": "npx",
      "args": ["-y", "oracle-sqlplus-mcp"],
      "env": {
        "ORACLE_CONNECTION": "scott/tiger@192.168.1.10:1521/ORCL",
        "SQLPLUS_PATH": "C:\\oracle\\instantclient_21_9\\sqlplus.exe",
        "QUERY_TIMEOUT_MS": "60000"
      }
    }
  }
}

Verfügbare Tools

Beispiel-Prompts

• "Teste die Oracle-Verbindung"

• "Liste alle Schemas in der Datenbank auf"

• "Zeige mir die Tabellen im SCOTT-Schema"

• "Beschreibe die Tabelle EMPLOYEES"

• "Hole 5 Beispielzeilen aus HR.EMPLOYEES"

• "Führe diese Abfrage aus: SELECT * FROM departments WHERE department_id < 50"

• "Liste alle gespeicherten Prozeduren im HR-Schema auf"

Fehlerbehebung

sqlplus: command not found

Setzen Sie SQLPLUS_PATH auf den vollständigen Pfad Ihrer sqlplus-Binärdatei.

ORA-12541: TNS:no listener

Überprüfen Sie Host, Port und ob der Oracle-Listener läuft.

ORA-01017: invalid username/password

Überprüfen Sie die Anmeldedaten. Format des Verbindungs-Strings: user/pass@host:port/service.

SP2-0306: Invalid option

Stellen Sie sicher, dass die sqlplus-Version den -S Silent-Modus unterstützt (alle modernen Versionen tun dies).