mcp-oci

Oracle Cloud Infrastructure (OCI) 를 위한 Model Context Protocol 서버입니다. MCP를 지원하는 클라이언트(Claude Desktop, Claude Code, Cursor, Copilot, …)가 실시간 OCI 리소스를 발견하고, 리소스 간의 관계를 매핑하며, 재현 가능한 Terraform을 생성할 수 있게 해 줍니다. 동작 방식은 전적으로 플래그로 제어됩니다.

클라우드용 Playwright-MCP라고 생각하면 됩니다. 모델이 인프라 지식을 수작업으로 다시 구축하지 않고 "prod 컴파트먼트에 있는 모든 VCN을 보여 줘", *"이 컴파트먼트에 대한 Terraform을 생성해 줘"*라고 요청하면, 구조화되고 시크릿이 없는 답변을 얻을 수 있습니다.

기능

• 실시간 발견 — 컴파트먼트, 리전, 그리고 OCI 리소스 검색(Resource Search)을 통한 모든 리소스.

• Terraform 생성 — 알려진 유형(VCN, subnet, instance, bucket, compartment)에 대해서는 충실한 HCL로, 그 외에는 주석이 달린 skeleton으로 생성. provider 변수가 포함된 컴파트먼트 전체 모듈.

• 의존성 그래프 — 노드/엣지와 함께 의존성 우선의 프로비저닝 순서 제안.

• 시크릿은 모델에 도달하지 않음 — 모든 응답 결과는 반환 전에 마스킹 처리됨.

• 보안 플래그 — 접근 모드, 컴파트먼트/리전 허용 목록, 프로비저닝 게이트, dry-run, JSON 감사 로그(아래 참조).

• 표준 인증 — OCI 설정 파일(~/.oci/config) 또는 instance principals. 서버는 자격 증명을 저장하지 않음.

Related MCP server: oci-mcp-server

보안 모델

도구

발견 (읽기): list_compartments, list_regions, search_resources, list_compartment_resources, get_resource

Terraform (읽기): generate_terraform, generate_compartment_terraform, build_dependency_graph

MCP 클라이언트와 함께 사용

이 도구는 Claude Code, Claude Desktop, Cursor, OpenAI Codex CLI, Windsurf, VS Code(Copilot) 등 모든 MCP 클라이언트와 함께 사용할 수 있습니다. 각 클라이언트별 설정 방법은 docs/CLIENTS.md 를 참고하세요.

설치

npm install
npm run build

구성

표준 OCI 구성 프로필을 지정하세요. 안전을 위해, 에이전트가 보려는 컴파트먼트에 대해 읽기 전용(inspect/read) 권한이 있는 IAM 사용자/정책을 사용하세요.

Claude Desktop / Claude Code / Cursor로 실행

{
  "mcpServers": {
    "oci": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-oci/dist/index.js"],
      "env": {
        "OCI_PROFILE": "DEFAULT",
        "OCI_MODE": "read-only",
        "OCI_COMPARTMENT_ALLOWLIST": "ocid1.compartment.oc1..xxxx",
        "OCI_REGION_ALLOWLIST": "us-ashburn-1"
      }
    }
  }
}

예시 프롬프트

• "모든 컴파트먼트를 나열하고 prod 컴퍼먼트의 모든 리소스를 보여줘."

• "VCN ocid1.vcn.oc1..…에 대한 Terraform을 생성해 줘."

• "… 컴파트먼트의 의존성 그래프를 만든 뒤 프로비저닝 순서를 알려줘."

개발

npm run dev        # watch mode
npm test           # security policy + terraform generation + graph + redaction
npm run typecheck

로드맵

• terraform plan / apply 실행 — read-write/admin 및 OCI_ALLOW_APPLY 등의 깃발 뒤에서 지원.

• 리소스 유형 매퍼 추가하기 (load balancer, database, DRG, IAM 등등).

• 환경 간 드리프트 비교.

배포

이 서버는 공식 MCP 레지스트리를 위해 server.json 및 npm 소유권 검증을 위한 mcpName 필드를 포함합니다. npm에 배포하고 MCP 레지스트리, Smithery, Glama, Cursor, PulseMCP에 등록하는 방법은 PUBLISHING.md 를 참고하세요.

라이선스

MIT