oracle-sqlplus-mcp

sqlplus를 연결 백엔드로 사용하는 Oracle Database용 MCP(Model Context Protocol) 서버입니다. Oracle Instant Client Node.js 바인딩이 필요 없으며, 작동하는 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 테이블 설명해줘"

• "HR.EMPLOYEES에서 샘플 행 5개 가져와"

• "다음 쿼리 실행: SELECT * FROM departments WHERE department_id < 50"

• "HR 스키마의 모든 저장 프로시저 나열"

문제 해결

sqlplus: command not found

SQLPLUS_PATH를 sqlplus 바이너리의 전체 경로로 설정하세요.

ORA-12541: TNS:no listener

호스트, 포트 및 Oracle 리스너가 실행 중인지 확인하세요.

ORA-01017: invalid username/password

자격 증명을 확인하세요. 연결 문자열 형식: user/pass@host:port/service.

SP2-0306: Invalid option

sqlplus 버전이 -S 자동 모드를 지원하는지 확인하세요 (모든 최신 버전은 지원합니다).