mcp-oci

Un servidor del Model Context Protocol para Oracle Cloud Infrastructure (OCI). Ofrece a un cliente compatible con MCP (Claude Desktop, Claude Code, Cursor, Copilot, …) la capacidad de descubrir recursos vivos de OCI, mapear cómo se relacionan y generar Terraform reproducible — con el comportamiento controlado totalmente por flags.

Puedes pensar en ello como un Playwright-MCP para tu nube: en lugar de reconstruir el conocimiento de la infraestructura a mano, el modelo puede preguntar "muestra todas las VCNs del compartimento prod" y "genera el código Terraform para este compartimento" y obtener respuestas estructuradas y sin secretos.

Características

• Descubrimiento en colaboración — compartimentos, regiones y cualquier recurso mediante OCI Resource Search.

• Generación de Terraform — HCL fiel para tipos conocidos (VCN, subnet, instance, bucket, compartimento) y esqueletos anotados para el resto; módulos para un compartimento completo con variables del proveedor.

• Graph de dependencias — nodos/flotas más un orden de aprovisionamiento sugerido (dependencias primero).

• Los secretos nunca llegan al modelo — cada payload se redacta antes de devolverlo.

• Flags de seguridad — modos de acceso, listas permitidas de compartimento/región, puerta de aprobación de aprovisionamiento, dry-run y registro de auditoría JSON (ver abajo).

• Autenticación estándar — archivo de configuración de OCI (~/.oci/config) o instance principals. El servidor no almacena credenciales.

Related MCP server: oci-mcp-server

Modelo de seguridad

Herramientas

Descubrimiento (lectura): list_compartments, list_regions, search_resources, list_compartment_resources, get_resource

Terraform (lectura): generate_terraform, generate_compartment_terraform, build_dependency_graph

Uso con tu cliente MCP

Funciona con Claude Code, Claude Desktop, Cursor, OpenAI Codex CLI, Windsurf, VS Code (Copilot) y cualquier otro cliente MCP; consulta docs/CLIENTS.md para la configuración específica de cada cliente.

Instalar

npm install
npm run build

Configurar

Asegúrate de que apunte a un perfil estándar de configuración de OCI. Por razones de seguridad, usa un usuario o política IAM con permisos de solo lectura (inspect/read) sobre los compartimentos que quieras que el agente vea.

Ejecutar con 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"
      }
    }
  }
}

Ejemplos de peticiones

• "Enumera todos los compartidos y muestra cada recurso del compartimento prod."

• "Genera Terraform para la VCN ocid1.vcn.oc1..…."

• "Construye un grafo de dependencias para el compartmento … y dime el orden de aprovisionamiento."

Desarrollar

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

Hoja de ruta

• Ejecución de terraform plan / apply por detrás de read-write/admin y con OCI_ALLOW_APPLY.

• Más mapeadores de tipos de recursos (balanceadores de carga, bases de datos, DRGs, políticas de IAM).

• Comparación de deriva entre entornos.

Publicación

Este servidor incluye un server.json para el registro oficial de MCP y un mcpName para la validación de propiedad en npm. Consulta PUBLISHING.md para publicar en npm y aparecer en el registro de MCP, Smithery, Glama, Cursor y PulseMCP.

Licencia

MIT