convez.ai
MCP ServerIntegração & APIsIntermediário
hyeya418

Oracle DB MCP Server

hyeya418/oracle-db-mcp-server

Consulte Oracle DB com linguagem natural no Claude Desktop/Code

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP baseado em Spring AI que expõe bancos de dados Oracle para consultas em linguagem natural via Claude. Oferece ferramentas seguras (somente leitura) para listar tabelas, descrever schemas e executar SELECT queries, com validação SQL rigorosa.

Instalação

$npx convez-ai hyeya418/oracle-db-mcp-server

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
14%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Exploração de schemas Oracle via Claude sem escrever SQL
  • Integração de dados Oracle em workflows de IA
  • Análise rápida de estruturas de banco de dados legacy

Veredito

MCP bem estruturado com segurança de leitura robusta (validação de SQL, limites de linhas). Ideal para equipes que precisam expor Oracle em ambientes Claude, mas requer Java 17+ e configuração manual de credenciais. Ausência de exemplos concretos de queries limita descoberta inicial.

README

A tradução para o português deste README ainda está na fila.

Oracle DB MCP Server

Spring AI 기반의 Oracle DB 읽기 전용 MCP(Model Context Protocol) 서버입니다. Claude Desktop / Claude Code에서 자연어로 Oracle DB를 조회할 수 있습니다.

기술 스택

  • Java 17
  • Spring Boot 3.5.15
  • Spring AI 1.1.7 (spring-ai-starter-mcp-server)
  • ojdbc11 23.4.0.24.05
  • 전송 방식: STDIO

제공 도구 (MCP Tools)

도구설명
listTables현재 스키마의 테이블 목록 조회
describeTable특정 테이블의 컬럼명 / 타입 / Nullable 조회
executeQuerySELECT 쿼리 실행 (최대 100행)

보안 (읽기 전용 강제)

SqlValidator가 실행 전 SQL을 검증합니다.

  • SELECT 또는 WITH(CTE)로 시작하는 단일 쿼리만 허용
  • INSERT / UPDATE / DELETE / DROP / ALTER / TRUNCATE / MERGE / CREATE 등 차단
  • 세미콜론(;)으로 여러 쿼리 연결 차단
  • -- / /* */ 주석을 제거한 뒤 검증 (주석으로 키워드 우회 방지)
  • FETCH FIRST 100 ROWS ONLY 자동 적용 (이미 제한이 있으면 존중)

환경 변수

하드코딩 없이 환경변수로 DB 접속 정보를 주입합니다.

변수예시
DB_URLjdbc:oracle:thin:@//localhost:1521/FREEPDB1
DB_USERNAMEshop
DB_PASSWORD****

빌드

# JDK 17 필요
./mvnw clean package -DskipTests

빌드 결과: target/oracle-db-mcp-server-0.0.1-SNAPSHOT.jar

Claude Desktop 연동

%APPDATA%\Claude\claude_desktop_config.json에 추가:

{
  "mcpServers": {
    "oracle-db": {
      "command": "C:\\Program Files\\Java\\jdk17\\bin\\java.exe",
      "args": [
        "-jar",
        "C:\\project\\oracle-db-mcp-server\\target\\oracle-db-mcp-server-0.0.1-SNAPSHOT.jar"
      ],
      "env": {
        "DB_URL": "jdbc:oracle:thin:@//localhost:1521/FREEPDB1",
        "DB_USERNAME": "your_username",
        "DB_PASSWORD": "your_password"
      }
    }
  }
}

설정 후 Claude Desktop 재시작.

Claude Code 연동

프로젝트 루트의 .mcp.json으로 자동 인식됩니다 (.gitignore에 포함되어 있으므로 직접 생성):

{
  "mcpServers": {
    "oracle-db": {
      "command": "C:\\Program Files\\Java\\jdk17\\bin\\java.exe",
      "args": [
        "-jar",
        "C:\\project\\oracle-db-mcp-server\\target\\oracle-db-mcp-server-0.0.1-SNAPSHOT.jar"
      ],
      "env": {
        "DB_URL": "jdbc:oracle:thin:@//localhost:1521/FREEPDB1",
        "DB_USERNAME": "your_username",
        "DB_PASSWORD": "your_password"
      }
    }
  }
}

로그

STDIO 전송 특성상 stdout은 JSON-RPC 전용이므로, 로그는 파일로만 출력됩니다.

기본 위치: ~/oracle-db-mcp-server.log

Ver o original no GitHub

Bom para

Relacionados