oracle/mcp

Repository containing MCP (Model Context Protocol) servers that provides a suite of tools for managing and interacting with Oracle products.

Oracle MCP Server 리포지토리

정의

Model Context Protocol (MCP) 서버의 참조 구현 모음입니다. 각 서버는 src/ 아래에 있으며 Python, Node.js, Java 등 서로 다른 언어로 작성되어 MCP의 언어 중립적 설계를 보여줍니다.

MCP의 기능

MCP는 클라우드 리소스 전반에서 도구, 데이터, 모델이 서로 통신하는 방식을 표준화하는 프로토콜입니다. MCP 서버는 Oracle 클라우드 특정 도구의 구체적인 세트를 구현하고 MCP 호환 클라이언트(예: Cline, Cursor, MCPHost)에 노출합니다.

주요 구성 요소

폴리글롯 서버 – 예: oci-cloud-mcp-server (Python SDK), oci-api-mcp-server (OCI CLI 래퍼), oci-javascript-mcp-server, oracle-db-mcp-java-toolkit 등.
공유 인증 모듈 – stdio 기반 및 HTTP 기반 서버 모두에서 OCI 자격 증명 해결 및 HTTP 토큰 교환을 처리합니다.
컨테이너 지원 – 일부 서버는 Podman로 빌드하고 실행할 수 있습니다.
개발자 도구 – 디버깅을 위한 Model Context Protocol Inspector 통합, Moon 기반 모노레포 워크플로우(proto, moon run …).

일반적인 워크플로우

경량 Python 도구 uv와 원하는 서버(예: uvx oracle.oci-cloud-mcp-server@latest)를 설치합니다.
OCI 자격 증명을 구성합니다(OCI CLI 프로필 또는 HTTP 모드용 IAM 기밀 앱).
서버를 MCP 클라이언트의 JSON 구성에 추가합니다(Cline, Cursor, MCPHost 예시).
stdio 또는 HTTP 서비스로 서버를 실행합니다(선택적으로 Podman 컨테이너 내에서).
클라이언트(또는 Inspector)를 사용하여 통합 MCP 인터페이스를 통해 Oracle 클라우드 도구, 모델 또는 데이터 파이프라인을 호출합니다.

대상 사용자

어떤 언어에서든 Oracle Cloud 서비스(컴퓨팅, 데이터베이스, 스토리지)를 호출하는 일관된 방법이 필요한 AI/ML 파이프라인을 구축하는 개발자.
사용자 정의 클라이언트를 작성하지 않고 MCP를 통해 새로운 Oracle 특정 기능을 노출하려는 도구 작성자.
프로토콜 스택을 처음부터 구축하는 대신 참조 구현을 선호하는 모델 오케스트레이션 워크플로우를 프로토타이핑하는 연구자.

빠른 시작

# 1. uv 설치
curl -LsSf https://astral.sh/uv/install.sh | sh
# 2. uv로 Python 3.13 설치
uv python install 3.13
# 3. (OCI 사용 시) OCI CLI 프로필 구성
oci session authenticate --region=us-phoenix-1 --tenancy-name=my-tenancy
# 4. 권장 서버 실행
uvx oracle.oci-cloud-mcp-server@latest
# 5. MCP 클라이언트 구성에 최소 JSON 스니펫 추가 (<profile_name> 대체)

컨테이너에서 실행

podman run -e ORACLE_MCP_HOST=0.0.0.0 -e ORACLE_MCP_PORT=8888 \
  -e OCI_REGION=us-phoenix-1 -e IDCS_DOMAIN=… \
  -p 127.0.0.1:8888:8888 oracle.oci-cloud-mcp-server:latest

개발 워크플로우

proto 설치(moonrepo.dev/docs/proto/install).
moon run <server>:test로 테스트 실행, moon run <server>:build로 배포판 빌드, moon run :lint :lock으로 리포지토리 전체 린트 및 잠금 파일 검사.
Python 서버의 경우 uv가 잠금 파일에서 격리된 가상 환경을 생성합니다. JavaScript 서버의 경우 npm이 사용됩니다.

성숙도

개념 증명 / 참조로 명시되어 있으며 프로덕션용이 아닙니다. 학습, 프로토타이핑, 기여에 적합합니다.

라이선스

리포지토리에는 LICENSE.txt 파일이 포함되어 있습니다(정확한 라이선스는 README에 나열되지 않았지만 소스에 제공됨).

요약: Oracle의 MCP Server 리포지토리는 Model Context Protocol을 통해 Oracle Cloud 도구를 노출하는 방법을 보여주는 다중 언어 쇼케이스로, AI/ML 개발자가 클라우드 리소스와 통일된 언어 중립적 방식으로 상호 작용할 수 있게 합니다.

oracle/mcp

Oracle MCP Server 리포지토리

관련