OracleDB MCP 서버

개요

• 이 프로젝트에서는 LLM에 대한 컨텍스트로 구성된 Oracle 데이터베이스 테이블/열을 제공하는 MCP - Model Context Protocol Server 설치합니다.

• 이를 사용하면 LLM이 Oracle Database와 상호 작용하고, SQL 문을 생성하고, LLM 프롬프트를 사용하여 결과를 반환할 수 있습니다.

Related MCP server: MCP Oracle Server

설치

• 패키지 설치

  지엑스피1

• Oracle DB Connection String 최소값을 갖는 폴더에 .env 파일을 생성합니다. 샘플 파일은 여기에서 다운로드할 수 있습니다.

• 위 폴더에서 uv run oracledb_mcp_server 사용하여 oracledb_mcp_server 서버를 테스트합니다.

클로드 데스크톱

• Claud Desktop에 대한 구성 세부 정보

  {
    "mcpServers": {
      "oracledb_mcp_server":{
        "command": "uv",
        "args": ["run","oracledb_mcp_server"],
        "env": {
            "DEBUG":"True",
            "COMMENT_DB_CONNECTION_STRING":"oracle+oracledb://USERNAME:PASSWORD@IP:PORT/?service_name=SERVICENAME",
            "DB_CONNECTION_STRING":"oracle+oracledb://USERNAME:PASSWORD@IP:PORT/?service_name=SERVICENAME",
            "TABLE_WHITE_LIST":"ACCOUNTS,CUS_ACC_RELATIONS,CUSTOMERS",
            "COLUMN_WHITE_LIST":"ACCOUNTS.ACC_AAD_ID,CUS_ACC_RELATIONS.CAR_CUS_ID,CUS_ACC_RELATIONS.CAR_AAD_ID,CUSTOMERS.CUS_ID"
        }
      }
    }
  }

구성

• 사용 가능한 환경 변수 목록

  • DEBUG : 디버그 로깅을 활성화합니다(선택적 기본값은 False입니다)

  • COMMENT_DB_CONNECTION_STRING : 주석에 대한 Oracle DB 연결 문자열입니다. (필수)

  • DB_CONNECTION_STRING : 쿼리 실행을 위한 Oracle DB 연결 문자열입니다. (필수)

  • TABLE_WHITE_LIST : 목록 형식 ["table1", "table2"]의 허용 목록 테이블 이름(필수)

  • COLUMN_WHITE_LIST : 목록 형식 ["table.column1", "table.column2"]의 허용 목록에 있는 테이블-열 이름(필수)

  • QUERY_LIMIT_SIZE : 제공되지 않으면 기본값은 10개 레코드입니다(선택적 기본값은 10개입니다)

인터셉터

npx @modelcontextprotocol/inspector uv --directory "D:\\MyDev\\mcp\\oracledb_mcp_server" run -m oracledb_mcp_server

기여하다

기여를 환영합니다.
자유롭게 풀 리퀘스트를 제출해 주시기 바랍니다.

특허

이 프로젝트는 MIT 라이선스 조건에 따라 라이선스가 부여되었습니다.

데모

Github 스타