Skip to main content
Glama
yeuidowanter

fn_ora_mcp

by yeuidowanter
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

Oracle MCP 서버

Claude Code 안에서 Oracle DB 패키지 코드를 자연어로 조회하는 MCP 서버입니다.

사전 조건

  • Python 3.10 이상 (권장: 3.12)

  • Oracle DB 접속 가능한 읽기 전용 계정

    • ALL_SOURCE, ALL_OBJECTS, ALL_PROCEDURES 뷰 SELECT 권한 필요

  • Claude Code 설치

Related MCP server: Oracle DB MCP Server

설치

1. 저장소 복사

git clone <저장소 URL>
cd oracle_mcp

2. Python 가상환경 생성 및 패키지 설치

# Python 3.12로 가상환경 생성
py -3.12 -m venv .venv

# 패키지 설치
.\.venv\Scripts\pip install fastmcp oracledb python-dotenv

3. 환경 변수 설정

.env.example을 복사해 .env를 만들고 실제 접속 정보를 입력합니다.

copy .env.example .env

.env 파일 편집:

ORACLE_HOST=192.168.0.1        # Oracle DB 서버 IP
ORACLE_PORT=1521               # 포트 (기본 1521)
ORACLE_SERVICE=ORCL            # 서비스명 또는 SID
ORACLE_USER=readonly_user      # DB 계정
ORACLE_PASSWORD=your_password  # DB 비밀번호
ORACLE_SCHEMA=TARGET_SCHEMA    # 조회 대상 스키마 (비워두면 ORACLE_USER 스키마 사용)

4. DB 연결 확인

.\.venv\Scripts\python verify_connection.py

아래와 같이 출력되면 성공:

[1/3] DB 연결 시도 중...
      연결 성공
[2/3] ALL_SOURCE 조회 권한 확인 ...
      ALL_SOURCE SELECT 가능
[3/3] ALL_OBJECTS 조회 권한 확인 ...
      ALL_OBJECTS SELECT 가능

[OK] Phase 1 검증 완료 - DB 연결 및 권한 정상

Claude Code 연동

프로젝트 루트에 .mcp.json 생성

{
  "mcpServers": {
    "oracle-mcp": {
      "command": "C:\\절대경로\\oracle_mcp\\.venv\\Scripts\\python.exe",
      "args": ["C:\\절대경로\\oracle_mcp\\server.py"]
    }
  }
}

C:\\절대경로\\oracle_mcp 부분을 실제 프로젝트 경로로 변경하세요. 예: C:\\Users\\홍길동\\source\\oracle_mcp

Claude Code 재시작

Claude Code를 완전히 종료 후 재시작하면 oracle-mcp 서버가 자동으로 연결됩니다.

사용법

Claude Code 채팅에서 자연어로 질문하면 됩니다.

패키지 검색

PKG_USER 로 시작하는 패키지 찾아줘
APPL 이 들어간 패키지 목록 알려줘

패키지 내 함수/프로시저 목록 조회

PKG_0000 패키지 안에 어떤 함수들이 있어?

패키지 전체 소스 조회

PKG_0000 패키지 소스 코드 보여줘

특정 함수/프로시저 코드 조회

PKG_0000 패키지의 FN_LOGIN 함수 코드 보여줘
PKG_MEMBER 의 PROC_UPDATE 프로시저 내용이 뭐야?

제공 툴 (MCP Tools)

툴 이름

파라미터

설명

get_package_source

package_name, object_name(선택)

패키지 전체 소스 또는 특정 함수/프로시저 코드 반환

list_package_objects

package_name

패키지 내 함수/프로시저 이름 목록 반환

search_packages

pattern

패키지명 패턴 검색 (% 없으면 자동으로 %pattern% 적용)

모든 파라미터는 대소문자 구분 없이 동작합니다.

주의사항

  • 조회 전용입니다. 패키지 코드 수정, 컴파일, 데이터 변경은 지원하지 않습니다.

  • .env 파일에는 DB 자격증명이 포함되므로 절대 Git에 커밋하지 마세요. (.gitignore에 등록되어 있음)

  • .mcp.json 도 경로 정보가 포함되므로 Git에 올리지 않는 것을 권장합니다.

  • 운영 DB 연동 시 반드시 읽기 전용 전용 계정을 사용하세요.

Install Server
F
license - not found
B
quality
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/yeuidowanter/fn_ora_mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server