oracle-sqlplus-mcp

MCP-сервер (Model Context Protocol) для Oracle Database, использующий sqlplus в качестве бэкенда для подключения. Не требует привязок Node.js для Oracle Instant Client — достаточно работающего бинарного файла sqlplus.

Предварительные требования

• sqlplus должен быть установлен и доступен в PATH (поставляется вместе с Oracle Instant Client или полным клиентом Oracle)

• Node.js 18+

Related MCP server: oracle-db-mcp

Установка

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

Формат строки подключения

username/password@host:port/servicename

Примеры:

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

Конфигурация Claude Desktop

Добавьте в ваш claude_desktop_config.json:

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

Дополнительные переменные окружения

Пример с пользовательским путем к sqlplus

{
  "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"
      }
    }
  }
}

Доступные инструменты

Примеры запросов

• "Проверь соединение с Oracle"

• "Перечисли все схемы в базе данных"

• "Покажи мне таблицы в схеме SCOTT"

• "Опиши таблицу EMPLOYEES"

• "Получи 5 примеров строк из HR.EMPLOYEES"

• "Выполни этот запрос: SELECT * FROM departments WHERE department_id < 50"

• "Перечисли все хранимые процедуры в схеме HR"

Устранение неполадок

sqlplus: command not found

Установите SQLPLUS_PATH на полный путь к вашему бинарному файлу sqlplus.

ORA-12541: TNS:no listener

Проверьте хост, порт и убедитесь, что слушатель (listener) Oracle запущен.

ORA-01017: invalid username/password

Проверьте учетные данные. Формат строки подключения: user/pass@host:port/service.

SP2-0306: Invalid option

Убедитесь, что версия sqlplus поддерживает тихий режим -S (все современные версии поддерживают).